Add a Mention Button

For: Page editors.

Add a Post to @username button, so readers can ask a public question on X. A click opens X in a new tab, with a new post that starts with the @username. Readers write the rest and post it from their own account.

Live example

This Mention Button uses @Atlassian.

We don't have a way to export this macro.

Try it: select the button. X opens in a new tab, with a new post that starts with @Atlassian. You post it only if you choose to.

On your own page, you can put the button below a line such as “Ask a public question”. In Prefilled post text, enter “I have a question about…”.

Before you start

  • You can edit this page.

  • You have a public profile URL or @username.

  • You do not need an X API key.

The question is public when the reader posts it on X. For a private message, use Message Button.

Add it to a page

  1. Open the page’s insert menu. Choose Mention Button.

  2. Enter a profile URL or @username in Item to share.

  3. Choose your settings and check the preview.

  4. Choose Insert.

  5. On a regular page, publish or update it. Others can then see what you added.

To change it later, open its editor.

In the editor, Mention Button is selected.
In the editor, Mention Button is selected.

Settings

Setting

What it does

Prefilled post text

Starting text for the public post.

First recommended account / Second recommended account

Suggested accounts passed to X.

Large button

Use a larger button.

Alignment on the page

Place the button left, center or right.

Widget language

Change the button label language. Automatic uses the reader’s language setting. Starting text stays in the language you wrote it in.

Check the result

View the page as a reader. Select the button and check that it opens the right action on X. Readers choose what to do on X.

On the published page, Confluence asks readers to confirm before the Mention Button opens X.
On the published page, Confluence asks readers to confirm before the Mention Button opens X.
Add mention button 4.png
On X, the reader gets a post draft addressed to @Atlassian.