Overview
The {space-metadata} macro lets you attach a single piece of metadata to a space (see the metadata macro for the equivalent functionality for pages).
The macro can be added to any page in the space for the metadata to be added to the space.
Parameters
Parameter | Required | Default | Notes | Version |
|---|---|---|---|---|
unnamed first parameter |
| This is the name given to the added metadata. The name is case sensitive. | ||
hidden | false |
Note that this option to hide or display the metadata value affects only the page that contains the {metadata} macro. It does not affect any pages where the metadata is reused. |
Usage
To add a single piece of metadata to a space, choose the 5303343474 in the Confluence macro browser:
Simply add your chosen metadata name to the macro editor e.g. Department. This metadata name will be case sensitive.
To add the value of the metadata, Insert the macro to the page and enter the metadata value into the metadata macro placeholder.
To see the display of the space metadata value on the current page, choose the macro placeholder Edit option.
The added space metadata value is now displayed in the macro editor Preview.
The space 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 "||Squadron Leader Comala|" is stored for the "Department" metadata. The wiki markup will create a filled cell of a table containing the text value of the metadata, "Department".
You can add the individual metadata from this space onto a page, for example, using the{space-metadata-from} macro. or one of the report macros.
The macros retrieving the metadata value will then render the markup into the page they are used on.
Reference Markup
{space-metadata:Department}Systems Support{space-metadata}
The metadata value name is added to the 5303343474. The value of the metadata is the contents of the body of the macro.
Adding the hidden parameter means the metadata value is not displayed on the page where the macro has been added. This will not affect the display of the metadata value when is retrieved on other content.
{space-metadata:Department|hidden=true}Systems Support{space-metadata}
Usage with the Comala Document Management app
The {space-metadata} macro is NOT supported by the Comala Document Management app and will not work at workflow level.
Related Comala Metadata macros
Related documentation
- Adding metadata to spaces
- Retrieving and displaying space metadata
- Using metadata in a space
- Example - Traffic Lights using space metadata
- Using metadata to define space hierarchies
- Confluence Internal Metadata