Dropdown list

Dropdown list

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.

dropdown_macro_editor.png
A Dropdown list field within the Field Group macro editor

Field settings

To open the Dropdown 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 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.

dropdown_content_editor.png
A Dropdown list field within the Field Group macro content editor

 

Need support? Create a request with our support team.

Copyright © 2005 - 2026 Appfire | All rights reserved.