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.

A Label list field within the Field Group macro editor

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

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: Select existing labels from the dropdown list. Enter a new label name and create it. The Create option when adding a new label
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.

A Label list field within the Field Group macro content editor