This page is a snippet

For full information, see:

Snippet

 

Macro name: recently-updated

Macro body: None.

Parameter nameRequiredDefaultParameter description and accepted values
spacesNoThe space that contains the page on which the macro is added.

Filters content by space. The macro will display only the pages and other content which belong to the space(s) you specify here.

You can specify one or more space keys, separated by a comma or a space.
  • To exclude content in a specific space, put a minus sign (-) immediately in front of that space key. For example: If you specify a space key of -BADSPACE you will get only content which is not in the BADSPACE.
  • To indicate that the results must come from a specific space, put a plus sign (+) immediately in front of that space key. For example: If you specify a space key of +GOODSPACE you will get only content in GOODSPACE. (Note that this is not particularly useful, because each content item belongs to one space only. If you put a plus sign next to one space key and list other space keys too, the other space keys will be ignored.)

Special values:

  • @self — The current space.
  • @personal — All personal spaces.
  • @global — All site spaces.
  • @favorite — The spaces you have marked as favourite.
  • @favourite — The same as @favorite above.
  • @all — All spaces in your Confluence site.
  • * — The same as @all above.

When specifying a personal space, remember to use the tilde (~) sign in front of the username, such as ~jbloggs or ~jbloggs@example.com.

authorNoAll users.

Filters by the username of the user who updated the content. The macro will only display content created and updated by the user(s) you specify here.

You can specify one or more authors, separated by a comma or a space.For example: jsmith,jbrown

To include content from one user, but exclude from another user: jsmith,!jbrown

maxNo15

The maximum number of results to be displayed.

The theoretical maximum value that this parameter can accept is 2 to the power of 31, minus 1 (or 2147483647). But this maximum is limited to 200 in the code, for performance reasons. More details are in this issue:  CONF-19096

hideHeadingNofalse

Determines whether the macro hides or displays the text 'Recently Updated' as a title above the list of content.

Accepted values:

  • true – Title is hidden.
  • false – Title is shown.
widthNo100%The width of the macro display, specified as a percentage of the window width.
themeNoconcise

Choose the appearance of the macro.

Accepted values:

  • 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 – Shows recent modifications in reverse chronological order, grouped by user in 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 the 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.
showProfilePicNofalse

Determines whether the macro displays profile pictures of the users who updated the content.

Accepted values:

  • true – the macro will show profile pictures.
  • false – the macro will not show profile pictures.
labelsNoNone. Labels are not used to filter the content.

Filters content by label. The macro will display only the pages and other content which are tagged with the label(s) you specify here. You can specify one or more labels, separated by commas.

Note: 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 ".

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.

  • To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of -badpage you will get only content which is not labelled with 'badpage'.
  • To indicate that the results must match a given label value, put a plus sign (+) immediately in front of that label value. For example: If you specify a label value of +superpage,+goodpage you will get only content which has at least two labels, being 'superpage' and 'goodpage'.

typesNoAll content types.

Filters content by type. You can specify one or more types, separated by commas.

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

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 -blogpost you will get pages and all other content except for blog posts.

Available values:

  • No labels