The Recently Used Labels macro displays a list of the labels that have been most recently added to a page, blog post or attachment. You can define the number of labels to be displayed and the scope (the current space, your personal space or site spaces, also known as 'global' spaces).

Using the Recently Used Labels macro

To add the Recently Used Labels macro to a page:

Parameters of this macro

Parameter

Default

Description

Number of Labels to Display
(count) 

10

Specifies the total number of labels to display in the list.

Scope for Retrieving Labels
(scope) 

global

Specifies the scope of labels to be displayed in the list. Valid values include:

  • global — covers all site spaces (non-personal) in the Confluence installation.
  • space — the current space.
  • personal — your own personal space.

List Style
(style) 

list

  • list – displays the list of labels horizontally.
  • table – includes additional information such as the page to which the label was added and the user who added it.

Table Title
(title) 

none

Adds a title to the top of the list in table style. Titles are only visible when the List Style parameter has been set to table.

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-used-labels

Macro body: None.

Storage format example

  <ac:structured-macro ac:name="recently-used-labels">
    <ac:parameter ac:name="title">My title</ac:parameter>
    <ac:parameter ac:name="scope">space</ac:parameter>
    <ac:parameter ac:name="style">table</ac:parameter>
    <ac:parameter ac:name="count">20</ac:parameter>
  </ac:structured-macro>

Wiki markup example

{recently-used-labels:title=My title|scope=space|style=table|count=20}