User Status List Macro

Status Updates are going away in Confluence 5.9.
Read more about this change.

The User Status List macro displays a history of a given Confluence user's status updates. This is the same history that appears in the user's  Status Updates view.

Screenshot: Example output of the User Status List macro

Using the User Status List macro

To add the User Status List macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Autocomplete for links, files, macros and mentions.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.


Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).






The username of the Confluence user whose history of status updates you wish to show.


Hint: If you wish to list status updates made by more than one user, you can use the Recently Updated macro with the following parameter values:

  • Include these Content Types Only: status
  • Author(s) by username: The user(s) whose status updates you want to include in the list. If you leave this field blank, the status updates of all users will be included.

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: status-list

Macro body: None.

Storage format example

<ac:structured-macro ac:name="status-list">
  <ac:parameter ac:name="username">
    <ri:user ri:userkey="12345678912345678912345678912345"/>

Wiki markup example


Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport