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:
Basic usage of the Page Properties and Page Properties Report macros
The Page Properties macro is used in conjunction with the Page Properties Report macro.
To use the macros:
- Add the Page Properties macro to your page and specify a label (for example, Status).
Add a two column table in the body of the macro placeholder for your metadata keys and values.
- Repeat this process to add the Page Properties macro to other pages.
- Create a new page to contain your report (for example, Status Report).
- Add the Page Properties Report macro and specify the same label (for example, Status).
- View your new status report page. The data contained in your Page Properties macros display in the report.
Screenshot: example 'Status' report
- Choose a column heading to sort the report.
When you insert the Page Properties macro on a page Confluence automatically adds the label to the page. You can add more than one Page Properties macro to the page, but they will inherit the same label (e.g. you cannot have two Page Properties macros with different labels on the same page).
Using the Page Properties macro
Add the Page Properties macro to the page:
- In the Confluence editor, choose Insert > Other Macros.
- Find and select the required macro.
Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.
To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.
- Add a label to the macro, using the macro parameters.
In the macro browser, add a Label. For example, "Status".
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
Parameters are options that you can set to control the content or format of the macro output.
Parameter | Default | Description |
---|---|---|
Label | (None) | The label used to identify the metadata on this page. Confluence will add this label to the page. Any additional Page Properties macros will inherit this label. |
Hidden | False | Determines whether the data in the Page Properties macro will be displayed on the current page. This setting does not affect the display of the detail in the Page Properties Report macro. |
Examples
The following examples outline how you can use the Page Properties and Page Properties Report macros together to create a Status Report or a Risk Report.
Code examples
See:
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.
Attachments:












