---
title: "Dropdown list"
canonical: "https://support.appfire.com/space/SCAFC/477471229/Dropdown%20list"
format: markdown
---
> Macro (aura-html)
The Dropdown list field in the Field Group macro creates a dropdown list for selecting one or more predefined options.
## Macro editor view
To insert a Dropdown list field into the Field Group macro editor, either drag it from the sidebar or use the `/dropdown list` command.
## Field settings
To open the Dropdown 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 options. Each label can have a distinct color.
To create labels for the dropdown list:
1. Enter a label name in the text box.
2. Select a color for the label
3. Press `Enter`. The label is auto-saved.
4. Repeat for each label.
For example, the labels can be:
- [not started]
- [in progress]
- [completed]
- [at risk]
> ✅ You can drag and rearrange the labels to define their display order in the content editor. |
| **Allow Multiple** | Boolean | False | If enabled, the field accepts selecting more than one option. |
| **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 Dropdown list field lets you select one or more predefined options.
