The Page Properties macro enables you to embed data on a page and then display that data in tabular form on another page . You can put the Page Properties macro on as many pages as you like and use the Page Properties Report macro to display the collected data on one page. You can also choose to hide the metadata on the pages that contain the Page Properties macro. This macro was previously known as the Metadata Details macro. On this page: Related pages: Include Page Macro Excerpt Include Macro Using Label Macros to Categorise Wiki Content Working with Macros Working with Confluence Labels Confluence Wiki Markup for Macros Confluence Storage Format for Macros Confluence User's Guide

Basic usage of the Page Properties and Page Properties Report macros

Using the Page Properties macro

1. Add the Page Properties macro to the page:
   
   

2. Add a label to the macro, using the macro parameters.
   In the macro browser, add a Label. For example, "Status".
     

3. Add metadata keys and values as rows in a table, in the body of the macro placeholder. 
   In the macro body add a two column table and remove the header row. In the left column specify the keys (these will be the column headings in your report. You cannot format this text). In the right column specify the values for each key.
   
   Screenshot: The macro placeholder in the Confluence editor
   

   

Parameters

Examples

Code examples

See:

• Confluence Wiki Markup for Macros
• Confluence Storage Format for Macros

Notes

• If you add a label to the parameter in the Page Properties macro, Confluence adds the label to the page.
  
  • If you remove the label from the Page Properties macro, the label remains on the page.
  • If you remove the label from the page but leave it in the Page Properties macro, Confluence puts the label back onto the page.  
• You can add many Page Properties macros per page, however all Page Properties macros on the page will have the same labels applied to them.  For example, if you add two Page Properties macros on a page, one with the label "risk" and the other with the label "status", both sets of metadata will appear in the Page Properties Report macro for the "status" label and for the "risk: label. This is true even if you have specified just one label in each Page Properties macro. It is the labels on the page that matter, not the labels in the macros.
• You cannot use text formatting or macros in the left column as the data in this column is used to populate the column headings in your Page Properties Report macro. 
• If your table has a header row, this row will be ignored by the Page Properties Report macro. You should remove the header row.
• It is not possible to reference the metadata using the metadata key from within the page, or anywhere else on a Confluence page.

Other metadata macros

There are other metadata macros, which are not supported or documented on this page but which are worth mentioning:

• {metadata-list} – Adds metadata keys and values. See Atlassian Answers.

• {metadata-values:pagename} – Displays the metadata values without the keys. You can use @self to get the metadata on the current page. See Atlassian Answers.
• {metadata-report}
• Macros added by the Confluence Metadata Plugin 2.