Add a Message Button

For: Page editors.

Add a Message button, so readers can write to an X account in private. A click opens X in a new tab, with a message to that account. Readers write and send it from their own account.

Live example

This Message button is set to the @Atlassian account. Try it: select it, and X opens a private message to that account in a new tab. You write and send it from your own account.

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

On your own contact page, you can put it below “Send a private message on X”.

Before you start

  • You can edit this page.

  • You have a profile URL, @username or X user ID made of digits.

  • For a profile or username, ask your admin to connect the site X API key. The app needs that key to find the ID. If you know the ID, you can use it without a key.

It works for all readers only if the account takes messages from anyone. Readers send the message on X. The page has no inbox.

Add it to a page

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

  2. Enter a profile URL, @username or X user ID made of digits 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, Message Button is selected.
In the editor, Message Button is selected.

Settings

Setting

What it does

Prefilled message text

Starting text the reader can review on 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 X, a first-time reader sees the X Chat welcome screen.
On X, a first-time reader sees the X Chat welcome screen.
On X, a first-time reader creates a Chat passcode.
On X, a first-time reader creates a Chat passcode.
Add message button 5.png
On X, a message to @Atlassian opens.