Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Is there a way to display the label field onto a page properties report in confluence?

I'd like to display in the page properties report the label assigned to a page in the Decision log.  I see there is a way to display a label when using the content by label macro.  In that macro there is a choice to display a label (show labels for each page).  I do not see a way to display a label in the page properties report macro.  Our users would like to see the label as a column to see as well as sort by.  We make many decisions on our project and are using the decisions log to track our decisions.  We want to categorize our like decisions and be able to see and sort by those categories.  We are trying to use labels as a way to categorize our decisions.  

3 answers

4 votes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Apr 10, 2019

Hello there!

Suzanne, you should be able to achieve this indeed. We will need to create a User macro. Here, let us start by creating the user macro:


Creating this user macro:

  1. Click the Cog Icon  > General Configuration > User macros.
  2. Once there, click create a user macro right at the bottom
  3. Under macro name, type a name for your macro (label-list for example)
  4. Select the desired macro visibility
  5. Type a macro title (Label List in our case)
  6. Select No Macro  Body
  7. Inside the Template field, paste this code:
    1. ## @noparams
      #set($currentPage = $pageManager.getPage($content.getId()))
      #set($pageLabels = $currentPage.getLabels())
      #foreach( $labelObject in $pageLabels )
      <span class="aui-label">$</span>

        8. Save

After the macro is created, we will then need to insert it into a Page Properties macro. Here is how mine looks like:

Screen Shot 2019-04-10 at 14.48.40.png


As you can see, the page labels are displayed within the table I created for the Page Properties macro with no problem. Now, when we use the Page Properties Report macro, my labels look like this:

Screen Shot 2019-04-10 at 14.49.10.png


  • You need to be an instance admin to create user macros


So, let us know if this helps you out Suzanne!


This user macro works very well thanks.

Would it be possible to add to this macro the feature to hide some labels? In the Page Properties Report some pages are labeled as "favourite", and there is also the label I use to gather the pages in the Page Properties Report.


Like Dan Turner likes this

As someone who is not an admin but sees this ability to list a label in Page Properties as a perfect solution to a big need we have (basically, a way to provide detailed info and faceted browsing in a list or table format), please incorporate this ability to the regular macro!

I strongly second this request. Would be most helpful in a variety of use cases for us.

0 votes
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
Mar 29, 2023

The macro stopped to work after our Confluence upgrade to 7.19.x. Then made a small change to make it work again.

  1. ## @noparams
    #set($currentPage = $pageManagerInternal.getPage($content.getId()))
    #set($pageLabels = $currentPage.getLabels())
    #foreach( $labelObject in $pageLabels )
    <span class="aui-label">$</span>

Hi @Niranjan thanks for your contribution, I have the exact same need as op!

I'm on Confluence version 7.19.7 and copied your code but it do not seem to work.

Is it really working fine on your side?

Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events