---
title: "Label list"
canonical: "https://support.appfire.com/space/SCAFC/477463909/Label%20list"
format: markdown
---
> Macro (aura-html)

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](media://2f04709a-f785-4e5d-a9e5-975c87fca62a)

## Field settings

To open the Label list field settings, select the field in the Field Group macro editor and click **Edit **(:edit-pencil:).

| **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](https://appfire.atlassian.net/wiki/spaces/RFC). |
| **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.<br>You can:<br>- Select existing labels from the dropdown list.
- Enter a new label name and create it. |
| **Allow Multiple** | Optional | False | If enabled, the field accepts selecting more than one label. |
| **Required** | Boolean | False | If enabled, the field is mandatory.<br>> ℹ️ 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](media://e90a9695-f67a-4da2-a1c4-810d131aed62)