Search the Confluence 4.1.x Documentation:

Index
Downloads (PDF, HTML & XML formats)
Other versions

This documentation relates to Confluence 4.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

 

The User Status List macro displays a history of any Confluence user's status updates on your Confluence page or blog. 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.

Parameters

When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.

Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.

Parameter

Default

Description

Username

none

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

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

  • 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.

Related Topics

Working with Macros

 User Status Updates
 

Take me back to the Confluence User's Guide.

Labels:
None
Edit Labels

23 Comments

Hide/Show Comments

  1. Jun 17, 2009

    jamiep77

    Is there a way to control the number of status updates shown?  It would be useful in many cases to be able to limit to the most recent update.

    1. Jun 18, 2009

      Zed Yap [Atlassian]

      Hi Jamiep77,

      As far as I know, the feature requested is not available yet. You might want to try to raise an improvement request in JIRA:

      Hope that helps
      Best rgds,
      Zed

      1. Jun 18, 2009

        jamiep77

        Thanks, I just created an improvement request for it:

        http://jira.atlassian.com/browse/CONF-16140

  2. Jun 24, 2009

    Anonymous

    We would like to add a status-list macro to the dashboard so that all user status changes are shown. This would be a great feature for giving a status page on what everybody is doing now.

    We would also like to limit how many status updates we would show for each user. This is a bit different from the other request made above. Something like this:

    1. Jun 24, 2009

      Zed Yap [Atlassian]

      Hi

      I think that will be a great feature. You might want to add your comment in this improvement request:

      Please vote on it and add yourself as a watcher for future updates. Also, please bare in mind the following document on how we schedule features for inclusion in our products: Implementation of New Features and Improvements.

      Hope that helps.
      Best rgds,
      Zed

    2. Jun 24, 2009

      Mark Hrynczak [Atlassian]

      You can achieve this by using the recently-updated macro instead.

      Something like:

      This will show the 30 most recent status updates. You could also restrict this to show them from specified users only.

      1. Jun 29, 2009

        Corey Connors

        Thanks Mark - that's exactly what I was looking to do.  Now the final touch: do you have any way that I can update the text "recently updated" above the status list?  I'm building an intranet design and every macro that I've created has "recently updated" above it - it would nice for the titles to be more specific to what types of updates people are looking at...

        1. Jun 29, 2009

          Mark Hrynczak [Atlassian]

          This is not possible in the current version. There is a similar existing improvement request - add your comment/vote to CONF-12430.

        2. Mar 19, 2010

          Nick Shilin Wu

          You can hide the title text by adding the parameter showHeading=false to your macro.

          For example:

      2. Aug 26, 2009

        Anonymous

        Can you clarify how to narrow it by user?  I don't see that as an option in the recently-updated macro.  Thanks.

        1. Aug 26, 2009

          Giles Gaskell [Atlassian Technical Writer]

          Hello there,

          The content in the recently updated macro documentation has been updated.

          Adding the author parameter to your {recently-updated:types=status} macro makes it show only specific users whose status updates you wish to view. This is done by adding each user's username for the value of this parameter. To list the status updates of more than one user, separate each relevant user's username with a comma.

          A tip's been added to the documentation above regarding this information.

          Kind regards,

          Giles Gaskell
          Technical Writer
          ggaskell@atlassian.com
          ATLASSIAN - http://www.atlassian.com

      3. Oct 18, 2010

        Julien Fischer

        That's a good tip, I used this type=status to display recently updated status of wiki users.

        Now I have a question: is it possible to limit this status list to a specific Wiki Space ? Because if I set for example "spaces=@personal" I get nothing. Alternatively, is it possible to limit these status updates to a specific user group ?

      4. Dec 20, 2010

        Stefan Lenis

        For some reason this is not working for me... the list remains blank...

  3. Jun 29, 2009

    Sean Winter

    Is there any way to associate a label with a user status update, much like a hashtag in Twitter? This would allow you to slide and dice status updates in numerouls different ways. thanks!

    1. Jun 29, 2009

      Mark Hrynczak [Atlassian]

      In the current version, no. A feature request has been raised as CONF-16223.

  4. Jan 07, 2010

    Anonymous

    Hi Guys,

    I would like to display the most recent update for the user currently logged in, just like with Facebook or Twitter.

    I understand how to do this by using the recently updated macro and giving a particular username, but I wwant it to dynamically change depending on who is logged in.  Is there a simple macro command I need for the username?

    Cheers,

    Steve

    1. Feb 05, 2010

      Thorarinn 'Toro' Stefansson

      I'll second that - as I am currently trying to find a way to do just that.

      In an effort to make a more personalized start-page (and to nudge users to update their outdated statuses).

      Something like author=current would solve this.

      1. Feb 18, 2010

        Felix Tunbjer

        You can use the following:

        cheers.//F

        1. Nov 30, 2010

          Okan A.

          This worked great as long as I am logged in. When I am not logged in, it displays an error saying that it cannot find a user logged in. I thought it would be smart enough not to display a user status, if a user was not logged in.

  5. Apr 20, 2010

    Anonymous

    Hi, just a quick one, for the note on having multiple users status updates using recently-updates, you do also need to add space=* or space=all for that to work.  Hope that's helpful to other people - took me a while to work that out myself!

  6. Jan 12, 2011

    Anonymous

    I have this but its not showing anything. Please help.

    • No recent updates found.

    1. Jan 12, 2011

      Luanne Pang

      i have this but its not working. please help

      {recently-updated:spaces=~lserafin|types=status|max=10|showHeading=false}

      Thanks.

  7. Oct 31, 2011

    Matthew Cornell

    The link to Status Updates view doesn't go anywere. Where is the documentation for this view? What I'd like is a Twitter-like list of all updates from all users.

    OK, found it: All Updates tab on the dashboard.