Display Metadata macro

Display Metadata macro

What can it do?

You can now embed the Display Metadata macro in a Confluence page.

By including it, you can choose to:

Display all the metadata you’ve assigned to the page
Display all the metadata you’ve assigned to other pages
Select and display only the metadata you need from the page

Display your macro in three easy steps:

After you’ve set the Metadata fields of your Content Category, follow the steps below:

1. Click on the plus sign to access the Macro Browser, and write “Display Metadata”.

image-20250609-031235.png

 

2. If the page you are currently working has a Content Category assigned, the option to display the corresponding metadata will be available automatically. Select the Metadata fields you’d like to display. You can choose between all the Metadata fields assigned to the page or only the ones you need :

image-20250624-100703.png

You can click on the small “x” sign to remove a Metadata field.

image-20250624-101437.png

3. See your Display Metadata Macro in action!

To make it easier to find the pages you're interested in, there's a filter option located next to Confluence page search. You can use this filter to select a specific Content Category that is assigned to the page you're looking for. This helps narrow down the results and makes it quicker to locate the content you need.

image-20250624-101224.png

 

If you attempt to include the Display Metadata macro on a Confluence page that is not assigned to a Content Category, you will have the option to search for other pages. However, if the selected page also does not have a Content Category assigned, an error message will be displayed.

image-20250624-101600.png
image-20250624-101629.png

Display Metadata macro is also supported in templates linked to a Content Category. You can choose which metadata to display, following the same instructions described above.

image-20250609-034056.png

 

But why should you use it? Some use case examples:

It’s a great way to build and insert the header of your documentation. Some examples include:

  • The header of your process documentation (role, document type, version, normative reference etc).

  • The header of your release documentation (software version, responsible person, user documentation, new features, etc).

  • The header of your product/project documentation (product manager, software architect, version, user documentation etc).

But don’t get limited by the header option only! You can choose to include the macro in any part of the page you’d prefer.