• Products
  • Documentation
  • Resources

Insert the recent updates macro

Use the Recent updates macro to insert a clickable list of the most recently created or updated pages, blog posts, attachments, and comments within a designated space, or across multiple spaces.

This is useful, for example, if you want to create a landing or informational page for a project or team. People viewing the list will only see the links for content they have permission to view.

You can customize what’s included in your list and how many results to display at a time.

This is a gif that shows how to use and configure the updated recent updates macro

To add a list of recent updates to your page: 

  1. From the editor, select (+) from the toolbar or type / to bring up the insert menu.

  2. Find the Recent updates macro and select it. You can also type /recentupdates to select this macro from the insert menu right in the body of your page.

  3. Upon selection, a list of recent updates will appear in the body of your page, if the selected space has updates. If not, a placeholder will appear.

  4. When you preview your page or publish it, a frameless list will appear.

The items in this list are dynamic — if additional updates take place, they'll automatically be reflected in the list.

To configure your recent updates macro: 

  1. While editing your page, select the Recent updates macro you want to configure.

  2. Select the Edit (pencil) icon to open the configuration panel.

  3. Customize the parameters of your list of recent updates via the Basic and/or Display tabs.

  4. Your selections will take effect instantly.

You can also select the centered, medium-width, or full-width icon to adjust the width of your list. Select the copy icon to duplicate it elsewhere, and/or the trashcan icon to remove it entirely.

Basic and display parameters

You can customize exactly how your list of recent updates appears on the page by configuring its Basic and/or Display parameters, depending on your needs and preference.

Note: If the parameter name in Confluence Cloud storage format or wikimarkup is different than the label that appears when configuring the macro, it will be listed below in parenthesis (example).

Basic parameters

Basic parameter




Current space

Search and select the space(s) from which you want to source your list of recently updated content.

Special values:

  • @self — The current space.

  • @personal — All personal spaces.

  • @global — All site spaces.

  • @favorite — The spaces you have marked as favorite.

  • @favourite — The same as @favorite above.

  • @all — All spaces in your Confluence site.

  • * — The same as @all above.

Include in list


Select the type of content update you want included in your list, choosing from the following:

  • Pages

  • Blog posts

  • Comments

  • Attachments

You can select one, a combination of several, or all of the above.

Show all updates


Toggle on to display all recent updates within a selected space or spaces at once, or toggle off to manually customize how many updates to display at a time.

Max number of updates


When the Show all updates toggle is off, this input field allows you to select the number of updates you want to display in your list at a time, up to 200 entries.

Display parameters

Display parameter



List style

Title + user name

This dropdown allows you to configure the style of how your list is displayed.

  • Title + user name - displays the titles of updated content items, along with the name of the user who contributed that update.

  • Title - displays the titles of updated content items only.

  • User name + profile picture - displays a user’s name and profile picture with content recently updated by them itemized below.

Filter by user


None specified

Search and select the specific user or users whose recent updates you want to display in your list.

Filter by label

None specified

Search and select specific labels to filter the results in your list, so only content with the designated labels will display.

Note: labels can only be applied to pages and blog posts.

List width


This dropdown allows you to choose what percentage of the macro frame your list will stretch across.

Hide list header


Toggle off to display Recent updates as a header above your list on the page. Toggle on to not include that header.

Wiki markup example

Wiki markup is only supported in the legacy editor.

Wiki markup is useful when you need to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name: recently-updated

Macro body: None.

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




Still need help?

The Atlassian Community is here for you.