Adding a single piece of metadata to a page

To add a single piece of metadata to a page, choose the Metadata (Metadata Plugin) macro in the Confluence macro browser:

macro browser metadata plugin option

Simply add your chosen metadata name to the macro editor e.g. Owner. This metadata name will be case sensitive.

macro editor dialogue box for Metadata Plugin

Insert the macro to the page.

Add the value of the metadata to the metadata macro placeholder.

To see the page display, choose the placeholder Edit option.

The added metadata value is now displayed in the macro editor Preview.

macro editor preview metadata plugin macro

The metadata macro body accepts both plain text and simple wiki markup for the value.

The metadata is stored as un-rendered wiki markup, so in this case the value "|Captain Comala|" is stored for the "Owner" metadata. The wiki markup will create a cell of a table containing the text value of the metadata, "Owner". 

metadata value page render unfilled table cell

If you don't want the metadata value displayed on this page, simply check the Hidden option in the macro editor. 

macro editor metadata plugin hidden checkbox

Note that this will not affect any pages where the metadata is reused.


Adding multiple pieces of metadata to a page

To add multiple pieces of metadata to a page, choose the Metadata List macro in the Confluence macro browser:

The macro editor allows you to configure the macro.


The macro editor only includes the following options for the macro:

  • display metadata as a vertical or horizontal list
  • hide the metadata from being displayed on this page
  • clear any existing metadata values of the page before setting the new metadata and values

You must Insert the macro to add the metadata names and their values using the {metadata-list} macro placeholder:

The metadata name and value can be plain text or include simple wiki markup. In the example above the metadata and their values are rendered in a table on the page:

Note this macro is for setting metadata values, not for listing existing metadata values. 


Related Comala Metadata macros

Other resources