To use the Property Group macro efficiently make sure to read the documentation on how to set up property groups and create properties first.
On this page
Embedding the Property Group macro
Create or edit a regular Confluence page and embed the Property Group macro:
In the Confluence editor, choose + > Other Macros
Find and select the Property Group macro
BILD
The macro placeholder (grey box) is displayed in the editor where you have added the macro to the page. The placeholder reflects the macro configuration. When inserting the macro for the first time there hasn’t been any configuration yet which is why it will always look as follows:
BILD
Using the macro in edit mode
Double-click the macro placeholder (or click the placeholder and choose Edit) to open the macro dialog window.
Select a previously created property group in the left sidebar of the macro dialog. Your assigned properties will appear which can be edited within there.
All entered values will be lost when you choose a different property group.
After filling out the properties you click on ‘Save’. The macro placeholder will reflect the applied values.
BILD
To edit the values just edit the macro again and save your changes. You can choose to edit your Confluence page or publish it.
Using the macro in view mode
The Property Group macro can also be used in the view mode. Everyone who can access the page (viewing permissions) can also view the macro.
BILD
All properties will be displayed, even the ones who have no values. To edit the properties you don’t need to go into the edit mode. By hovering over the properties you can change the values directly.
BILD
Only users editing permissions can interact with the macro.
All properties can be edited here without any limitations. After changing a value a confirmation is required.
BILD
Reviewing the change log
All actions within the Property Group macro are logged. Below the macro the name and timestamp of the last editor is displayed.
BILD
By clicking on this hint you can access the change log.
BILD
All edits are listed in the change log. This includes:
Name of the editor
Time of the edit
Previous value
New value
Once you remove the Property Group macro the corresponding change log is deleted.
Next
Learn how to display collected information that is stored in the Property Group macros in a clear and comprehensive table.