The Recently Updated macro displays a list of the most recently changed content within Confluence.

Using the Recently Updated Macro

To add the Recently Updated macro to a page:

Parameters

Parameter

Default

Description

Author(s) by username
(author) 

None specified. That is, display all content

Filter the results by author. The macro will display only the pages etc which were last modified by the author(s) you specify here.

You can specify multiple users.

Space(s)
(spaces) 

@self

That is, the space which contains the page on which the macro is used

This parameter allows you to 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 a comma or a space.

Special values:

Label(s)
(labels) 

None specified i.e. display all content

Filter the results 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 label values, separated by a comma or a space.

The labels parameter only applies to the page and blog content types.

Width of Table
(width) 

100%

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

Include these Content Types Only
(types) 

All types

This parameter allows you to filter content by content type. The macro will display only the content of the type you specify here.

You can specify one or more types, separated by a comma or a space.

Available values:

Maximum Number of Results
(max) 

15

Specify the maximum number of results to be displayed. If this parameter is omitted, then a maximum of 15 results are displayed. The theoretical maximum value that this parameter can accept is 2 to the power of 31, minus 1 (or 2147483647), though this has been limited to 200 in the code, for performance reasons. More details are here.

theme
(theme) 

concise

Choose the appearance of this macro:

  • concise — the default list, showing the names of pages which were updated or commented on, the users who made the page modifications and time when the modifications occurred.
  • social — lists recent modifications in reverse chronological order, but groups them by user into short time segments. A 'sub' list appears within each user's time segment, showing the names of pages which they updated or commented on and time when these modifications occurred.
  • sidebar — lists recent updates in reverse chronological order, showing the names of pages which were updated or commented on and time when the page modifications occurred. This theme does not show authorship.

Show User Profile Pictures
(showProfilePic) 

false

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

Hide Title
 (hideHeading)

False

Determines whether the macro hides or displays the text 'Recently Updated' as a title above the list of content. Only available in wikimarkup and storage format.

Accepted values:

  • true – Title is hidden.
  • false – Title is shown.

Notes

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: recently-updated

Macro body: None.

Storage format example

<ac:structured-macro ac:name="recently-updated">
  <ac:parameter ac:name="spaces">
    <ri:space ri:space-key="ss"/>
  </ac:parameter>
  <ac:parameter ac:name="author">
    <ri:user ri:userkey="12345678912345678912345"/>
  </ac:parameter>
  <ac:parameter ac:name="users"/>
  <ac:parameter ac:name="max">10</ac:parameter>
  <ac:parameter ac:name="width">50%</ac:parameter>
  <ac:parameter ac:name="theme">sidebar</ac:parameter>
  <ac:parameter ac:name="labels">choc</ac:parameter>
  <ac:parameter ac:name="types">page</ac:parameter>
</ac:structured-macro>

Wikimarkup example

{recently-updated:spaces=ds|author=admin|max=10|hideHeading=true|width=50%|theme=sidebar|showProfilePic=true|labels=choc|types=page}