Add Dropdown

Audience: Low-code Engineers

Skill Prerequisites: Forms, Tokens

Adds a dropdown list to a Dynamic Field Container when the form loads. It works like a Dropdown field placed in the form builder.

See Dynamic Fields for how dynamic fields work and how to set up the container.

Typical Use Cases

• Ask users to choose a status, size or category for each item in a list
• Add a dropdown whose options come from a database query

Don't use it to

• Offer a long list of options. Use Add Dropdown with Autocomplete, which lets users search.
• Allow several selections. Use Add Dropdown with Checkboxes or Add Checkbox List instead.

Related Actions

Action Name	Description
Add Dropdown with Autocomplete	Adds a searchable dropdown.
Add Radio Boxes	Shows all the options as radio buttons.

Input Parameter Reference

This action has the common parameters, except Secure Input and Readonly, and the list parameters, including Link To. It also has:

Parameter	Description	Supports Tokens	Default	Required
Title When No Selection	The text of an empty first option, for example Please select.	Yes	empty string	No
IsEnabled	When unchecked, the dropdown is disabled. Enable Conditionally overrides it.	No	Checked	No
"Other" Option	The text of an extra option that lets users type their own value, for example Other. Leave empty to not offer it.	Yes	empty string	No

Set Initial Value to the value of the option to select when the form loads.

Output Parameters Reference

Parameter	Description
Field ID Token Name	Optional. Token that receives the cleaned field ID. If empty, the ID is saved in [<FieldId>:Name].

When the form is submitted, the selected value is available in [<FieldId>].

Examples

tip

To understand how to use the below examples, please see Running Examples.

1. Add a T-shirt size dropdown

Add this action to the form's On PreInit or On Init actions. It adds a required size dropdown with a fixed list of options to the ExtraFields container.

{
    "Title": "Add Dropdown",
    "ActionType": "AddDynamicMultipleChoiceWithDropDown",
    "Description": "Add the T-shirt size",
    "Condition": null,
    "Parameters": {
        "ContainerId": "ExtraFields",
        "FieldId": "ShirtSize",
        "FieldName": "T-shirt size",
        "InitialValue": "",
        "Empty": "Please select",
        "IsEnabled": true,
        "Other": "",
        "DataSource": {
            "Expression": "",
            "Value": "Items",
            "IsExpression": false,
            "Items": "Small|S\nMedium|M\nLarge|L"
        },
        "TokenizeParameters": true,
        "LinkToFields": "",
        "IsRequired": "true",
        "FieldIdTokenName": ""
    }
}

Revised 09/25/2026