Label list
The Label list field in the Field Group macro creates a dropdown list for selecting labels to apply to the current page.
The Label list field functions like manually adding labels to a Confluence page, but it helps reduce labeling errors and enforces consistent content workflows.
Macro editor view
To insert a Label list field into the Field Group macro editor, either drag it from the sidebar or use the /label list command.
Field settings
To open the Label list field settings, select the field in the Field Group macro editor and click Edit ().
| Parameter | Type | Default value | Description | 
|---|---|---|---|
| Field name | Required | A random name is generated by default. | A unique name for the field. Used when integrating Scaffolding with other apps such as Reporting for Confluence. | 
| Helper text | Optional | N/A | Context or additional information about the field input. Displayed below the field only in content edit mode. | 
| Labels | Optional | N/A | The labels for the dropdown list. You can: 
 | 
| Allow Multiple | Optional | False | If enabled, the field accepts selecting more than one label. | 
| Required | Boolean | False | If enabled, the field is mandatory. In the content editor, attempting to save the form with a mandatory field left empty results in an error. | 
Content editor view
When editing content in the Field Group macro, the Label list field lets you select a label from the predefined list and apply it to the current page.
Need support? Create a request with our support team.
