Confluence Docs 3.0 : Recently Updated Dashboard Macro This page last changed on Jun 03, 2009 by ggaskell. 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 Usage with the Wiki Markup Editor Parameters Examples 1. Include all spaces and limit the display width to 50% 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 6. Display recent comments, including profile pictures and text ## Usage with the Macro Browser To insert the recently updated dashboard macro into a page using the Macro Browser, Open your desired Confluence page, then click the 'Edit' button. The 'Edit Page' mode opens. Next, click the Macro Browser icon on the editor toolbar. The Macro Browser will open in the middle of the screen. In the Macro Browser, type the name of your desired macro into the search box at the top right of the window. Macros with a matching name will appear in the centre pane. Click on the desired macro to see its options screen. Here, you can set the macro parameters then click 'insert' to put the macro into the page. 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} | Recently Updated
by Giles Gaskell [Atlassian Technical Writer] (3 hours ago) Development Release Warnings
by Don Gamble (4 hours ago) Re: Release Notes 3.1-m7 ("Milestone 7")
by Don Willis (4 hours ago) Recognised System Properties
by Giles Gaskell [Atlassian Technical Writer] (6 hours ago) Displaying an Office Document in Confluence
by Brendan Patterson (7 hours ago) Re: Release Notes 3.1-m7 ("Milestone 7")
by Jesse Rehmer (7 hours ago) Re: Release Notes 3.1-m7 ("Milestone 7")
by Anonymous (9 hours ago) Re: Livesearch Macro
by Anonymous (9 hours ago) Re: Livesearch Macro
by Steve Smith (10 hours ago) Re: Children Display Macro
by Steve Smith (10 hours ago) Re: Content by Label Macro
## Parameters Parameters are settings for Confluence macros that allow the user to control their content or presentation. The table below lists relevant parameters for this macro. Parameter names are displayed differently in the macro browser interface and in wiki markup. Below, parameter names used in the macro browser are indicated in Bold text, while their equivalents in wiki markup are indicated in (`bracketed`) text. If the latter is not shown, then in wiki markup, the parameter's name should be omitted and only its value should be added immediately after the colon symbol (`:`).
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. 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.
    {recently-updated-dashboard:spaces=*|width=50%}
#### 2. Specify the spaces for which you want to view recently updated content
    {recently-updated-dashboard:spaces=Name1,Name2|width=50%}
#### 3. Specify the width of the macro display
    {recently-updated-dashboard:width=50% }
#### 4. Filter content using labels
    {recently-updated-dashboard:spaces=sales,marketing|labels=timesheets,summaries}
#### 5. 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}
#### 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. 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}
| 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 Confluence User Guide.

Document generated by Confluence on Nov 05, 2009 23:35