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

[suzanne.potter]

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.  

[Diego]

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())
      <span>
      #foreach( $labelObject in $pageLabels )
      <span class="aui-label">$labelObject.name</span>
      #end
      </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:

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:

Notes:

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

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

[Emanuele Festa]

Hello,

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.

thanks!