Label list

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.

labels_list_macro_editor.png
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.

    label_list_new_label.png
    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.

labels_list_content_editor.png
A Label list field within the Field Group macro content editor

 

 



Need support? Create a request with our support team.

Copyright © 2005 - 2025 Appfire | All rights reserved.