Recently Updated Macro
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:
- In the Confluence editor, choose Insert > Other Macros
- 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
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).
Parameter | Default | Description |
|---|---|---|
Author(s) by username | 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. |
Space(s) |
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.
Special values:
When specifying a personal space, remember to use the tilde (~) sign in front of the username, such as |
Label(s) | 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.
The labels parameter only applies to the |
Width of Table | 100% | Specify the width of the macro display, as a percentage of the window width. |
Include these Content Types Only | 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.
To exclude content of a given content type, put a minus sign (-) immediately in front of that content type. For example: If you specify a content type of Available values:
|
Maximum Number of Results | 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 |
| Choose the appearance of this macro:
|
Show User Profile Pictures |
| Specify |
Hide Title | 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:
|
Notes
- The Recently Updated Dashboard macro is similar to this macro, but is intended for display on the Confluence dashboard.
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.
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}