Breadcrumbs

Embed a profile timeline

For: Page editors.

Show the latest posts from an X profile on your page. Readers can keep up with a partner next to your notes.

Live example

The Atlassian profile, live on this page

This timeline shows the latest posts from the Atlassian profile on X. It shows 5 posts in the center of the page.

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

Try it: click a post. It opens on X in a new tab, where you can reply or repost from your own account.

On a partner page, add a short note about the account and place its timeline below it. Readers can keep up with the partner without leaving the page.

On the published page, readers see the profile timeline.
On the published page, readers see the profile timeline.

Before you start

  • You can edit this page.

  • You have a public profile URL or @username.

  • Ask your admin to connect the X API key with the access and credits needed for timelines.

With the key, posts refresh at the times your admin sets. Without the key, the app may try X’s public embed. It can show few posts or none.

Add it to a page

  1. Open the page’s insert menu. Choose Embedded Timeline.

  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, Profile Timeline is selected.
In the editor, Profile Timeline is selected.

Settings

Setting

What it does

Full width

Use the available page width. Turn off to show width and alignment controls.

Widget width

220–1200 px when Full width is off. Leave blank for the 600 px default.

Widget height

Optional; at least 200 px. Sets a height limit. Readers can scroll inside the timeline.

Alignment on the page

Left, center or right when Full width is off.

Max posts to show

5–100. Limits the main post list. A pinned post or parts of a thread can add more content. You may see fewer posts if X cannot return them.

Show header / Show footer

Show or hide the timeline header and footer.

Show border

Show or hide the border.

Show scrollbar

Available when you set a height.

Transparent background

Let the page background show through.

Widget language

Sets X labels when the public embed is used. The app’s own timeline labels follow the reader’s Confluence language. Posts are not translated.

Check the result

View the page as a reader. Check that it shows the content you chose. If it will not load, open the source on X. For next steps, use Fix a problem.

Formerly titled “Lists”, “Add a profile or List timeline”.