View Source

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

The Recently Updated Dashboard macro is similar to this one, but is intended for display on the Confluence dashboard.

On this page:

Basic Usage

{recently-updated}

Working Example of Usage

Below is a working example of the 'Recently Updated' macro which by default, lists 15 results.

What you need to type	What you will get
{recently-updated}

Optional Parameters

Parameter	Default	Description
author	None specified i.e. 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 one or more authors, separated by a comma or a space.
label	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. 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.
labels	None specified i.e. display all content	Exactly the same as `label` above.
max	15	Specify the maximum number of results to be displayed. Note that the results are sorted first, and then the maximum parameter is applied. 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).
maxResults	15	Exactly the same as `max` above.
reverse	false	Use this parameter in conjunction with the `sort` parameter described below. Set `reverse=true` to change the sort from ascending to descending order. Note: this parameter is ignored if the `sort` parameter is not specified.
showProfilePic	false	Specify `showProfilePic=true` to display the profile pictures of the users who updated the content.
sort	modified	Specify how the results should be sorted. To change the sort order from ascending to descending, use the `reverse` parameter described above. Note: If this parameter is not specified, the sort order defaults to descending order based on the last modification date. Values:
space	@self, i.e. the space which contains the page on which the macro is coded	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:
spaces	The space which contains the page on which the macro is coded	Exactly the same as `space` above.
type	all	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:
types	all types	Exactly the same as `type` above.
width	100%	Specify the width of the macro display, as a percentage of the window width.

Examples

1. Include content from all spaces

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

{recently-updated:space=@all}

2. Include content from specific spaces

Use the code below to specify the spaces for which you want to view recently updated content:

{recently-updated:space=SPACEKEY1,SPACEKEY2}

3. Specify the width of the display

Use the code below to limit the width of the display to 50% of the window:

{recently-updated:width=50%}

4. Filter content using labels

The code below will include recently updated content labelled with 'timesheets' or 'summaries', from the 'sales' and 'marketing' spaces, provided that the content is not labelled with 'obsolete':

{recently-updated:space=sales,marketing|label=timesheets,summaries,-obsolete}

5. Sort the results

Use the code below to sort the list of items by date last modified, with the most recent at the top:

{recently-updated:sort=modified|reverse=true}

6. Filter by content type

Use the code below to show pages only (not news items, comments or any other content type) and sort the list of items by date last modified, with the most recent at the top:

{recently-updated:sort=modified|reverse=true|type=page}

7. Change the number of results in the list

The code below changes the number of results listed (from the default value of 15) to 8:

{recently-updated:maxResults=8}

8. Display profile pictures

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

{recently-updated-dashboard:showProfilePic=true}

9. 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.
This is the only way to ensure that the text of the comments is displayed, using this macro.

{recently-updated-dashboard:types=comment|showProfilePic=true}

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.