Page Properties Macro

Screenshot: A project page with status information presented in a Page Properties macro. 

Screenshot: A page with a Page Properties Report macro showing status information from the Page Properties macro on several different project pages.

Add this macro to your page

There are quite a few steps involved to set up this macro correctly, but once it's done, it's very easy to copy the macro to other pages, or add it to a template. 

To add the Page Properties macro to a page:

1. Unable to render {include} The included page could not be found.
2. Choose Page Properties from the Confluence content category.
3. Choose Insert.
4. In the macro body create a two column table
5. In the left column list your 'properties' – these will be the column headings in your report table.
6. Apply the Heading column style to the left column - this will indicate to the Page Properties Report macro that these are your properties. 
7. In the right column list the value for each property – these will populate the rows in your report table
8. Save your page.
9. Add a label to your page - you'll need to specify this label in the page properties report macro

Next you need to add the Page Properties Report macro to a different page.

Screenshot: The Page Properties macro on a page in the editor, with a vertical layout. 

Page properties layout options

Horizontal or vertical layout

You can choose to arrange the properties in your table vertically or horizontally.  Just make sure you apply the Heading row or Heading column style to your properties, to tell the Page Properties Report macro, where to find them. 

Here's an example of a horizontal layout.

Screenshot: The Page Properties macro on a page in the editor with a horizontal layout. 

Hidden or visible

You can choose whether the contents of the Page Properties macro should be visible when someone views the page. 

This is useful when the information isn't relevant to everyone. For example if you're using this macro to track when a policy was last reviewed and approved, you may only want that info to be visible on the page containing the Page Properties Report macro, not the page itself. 

Screenshot: Configuring the Page Properties macro to be hidden.

Using multiple Page Properties macros on one page

You can add multiple Page Properties macros on a single page, and choose whether to include all or only specific macros in the report. You might use multiple macros because you want the information in the macro to display in context with the rest of the page, or because you want to be able to report on individual Page Properties macros separately. 

The Page Properties macro includes an optional ID parameter that can be used to identify specific Page Properties macros. 

To show the contents of all Page Properties macros in the report:

1. Add a label to the page containing the Page Properties macros
2. Specify this label in the Page Properties Report macro

To show the contents of selected Page Properties macros in the report:

1. Add a label to the page containing the Page Properties macros
2. Specify an ID in the Page Properties macro that you want to report on
3. Specify both the label and ID in the Page Properties Report macro

Note: The Page Properties Report macro can only accept one page label, and one ID.

Change the macro parameters

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

Limitations

• You can't use macros in the left column as the data in this column is used to populate the column headings in your Page Properties Report macro. 
• It is not possible to reference the metadata using the metadata key from within the page, or anywhere else on a Confluence page.
• There's a known issue where the macro does not work correctly when placed inside an expand macro, which is inside a panel macro. See  CONFSERVER-59594 - Getting issue details... STATUS .

Other ways to add this macro

Add this macro as you type

Add this macro using wiki markup