Child pages
  • Recently Updated Dashboard Macro
Skip to end of metadata
Go to start of metadata

The Recently Updated Dashboard macro displays a list of the most recently changed content within Confluence. It is similar to the Recently Updated macro but is intended for use on the Confluence dashboard.

On this page:

Usage with the Macro Browser

To insert the recently updated dashboard macro into a page using the Macro Browser,

  1. Open the Confluence page or blog post that you want to edit, then click the 'Edit' button.
  2. Click the Macro Browser icon on the toolbar. The macro browser window will open.
  3. Scroll through the list of macros to find the one you want. Alternatively, start typing the macro name into the search box at the top right of the macro browser. Macros with a matching name will appear in the main pane.
  4. Click the desired macro.
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to add the macro onto the page.

(tick) You can also insert macros via autocomplete. For more information, see Using Autocomplete in the Rich Text Editor.

Once you've found the recently updated dashboard macro and have added the required parameter values, click 'insert' to add it to your page.

Usage with the Wiki Markup Editor

What you need to type

What you will get

{recently-updated-dashboard}

This tab shows all recently updated content. Create some content to see it appear here.

    Parameters

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

    Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

    Parameter

    Required?

    Default

    Description

    Label(s)
    (labels)

    no

    none

    Filter content by label. The macro will display only the pages etc which are tagged with the label(s) you specify here. You can specify one or more labels, separated by commas.
    (info) If there are no pages matching any of the specified labels, then Confluence will ignore the labels and will list all recently updated pages, as well as showing a message, "These labels don't exist and were ignored: xxx ". This unexpected behaviour is noted in issue CONF-10167.

    Show User Profile Pictures
    (showProfilePic)

    no

    false

    Specify showProfilePic=true to display the profile pictures of the users who updated the content.

    Space(s)
    (spaces)

    no

    The space which contains the page on which the macro is coded

    Filter content by space. The macro will display only the pages etc which belong to the space(s) you specify here. You can specify one or more space keys, separated by commas. '*' means all spaces.

    Include these Content Types Only
    (types)

    no

    all types

    Filter content by type. You can specify one or more types, separated by commas. Available types are: page, blogpost or news, spacedesc, attachment, comment, mail, userinfo.

    Width of Table
    (width)

    no

    100%

    Specify the width of the macro display, as a percentage of the window width.

    Examples

    1. Include all spaces and limit the display width to 50%

    The code below will show all the pages from all the spaces that have been recently updated.

    2. Specify the spaces for which you want to view recently updated content

    3. Specify the width of the macro display

    4. Filter content using labels

    5. Display profile pictures

    The code below will display the profile picture of the user who most recently updated the content.

    6. Display recent comments, including profile pictures and text

    The code below will display recent comments in the current space, showing the profile picture of the users who made the comments, plus the first line or two of the comment text.
    (info) This is the only way to ensure that the text of the comments is displayed, using this macro.

    Customising the wording

    If you would like to change the wording displayed by the 'Recently Updated' macro, please refer to the document on modifying the Confluence interface text.

    RELATED TOPICS

    Recently Updated Macro
    Viewing Recently Updated Content
    Working with Macros

    Take me back to the Wikis Help Guide.