Popular Labels Macro

Add the Popular Labels macro to a page to highlight the most popular labels used throughout your Confluence site or within a space. A popular label is a label that has been added to many pages. 

This is great for surfacing labels that might be trending in your site, for example in a knowledge base. 


On this page:

Screenshot: The Popular Labels macro showing a heatmap of the 20 most popular labels.


For general information about using labels in Confluence, see Add, Remove and Search for Labels.

Add this macro to your page

To add the Panel Map macro to a page:

  1. Unable to render {include} The included page could not be found.
  2. Choose Popular Labels from the Reporting category.
  3. Enter any parameters and choose how you want the labels to display. 
  4. Choose Insert

You can then publish your page to see the macro in action. 

Screenshot: specifying a space key, number of labels, and heatmap display style. 

Change the macro parameters

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Here's a list of the parameters available in this macro. 

Parameter

Default

Description

Number of Labels to Display
(count

100

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

Restrict Labels to this Space Key
(spaceKey

none

Restricts the list of popular labels to the specified space.

Style of Labels
(style

list

  • list – displays the popular labels as a bulleted list, ordered by popularity (highest first).
  • heatmap – displays the popular labels using different font sizes for each label depending on the label's popularity, ordered by label names.

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Other ways to add this macro

Add this macro as you type

Unable to render {include} The included page could not be found.

Add this macro using wiki markup

Unable to render {include} The included page could not be found.

Macro name: popular-labels

Macro body: None.

{popular-labels:style=heatmap|count=20|spaceKey=ds}
Last modified on May 20, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.