Add Dropdown with Checkboxes

Audience: Low-code Engineers

Skill Prerequisites: Forms, Tokens

Adds a dropdown where users can tick several options to a Dynamic Field Container when the form loads. It takes less space than a checkbox list. It works like a Dropdown with Checkboxes field placed in the form builder.

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

Typical Use Cases

• Let users choose several interests, skills or locations from a medium-sized list
• Limit how many options can be picked, for example "choose up to 3"

Don't use it to

• Allow only one selection. Use Add Dropdown instead.

Related Actions

Action Name	Description
Add Checkbox List	Shows all the options as checkboxes.
Add Tags Input	Lets users enter several values as tags.

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
Count Selections	Enter true to show the number of selected options in the closed dropdown, or false to show the selected options' texts.	Yes	empty string	No
Maximum Number of Selections	The most options a user can tick. Leave empty for no limit.	Yes	empty string	No

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, [<FieldId>] holds the selected values separated by commas. See Values of list fields.

Examples

tip

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

1. Choose up to three interests

Add this action to the form's On PreInit or On Init actions. It adds an interests dropdown to the ExtraFields container, allowing up to three selections.

{
    "Title": "Add Dropdown with Checkboxes",
    "ActionType": "AddDynamicDropdownWithCheckboxes",
    "Description": "Add the interests dropdown",
    "Condition": null,
    "Parameters": {
        "ContainerId": "ExtraFields",
        "FieldId": "Interests",
        "FieldName": "Interests",
        "InitialValue": "",
        "CountSelections": "false",
        "MaxSelection": "3",
        "DataSource": {
            "Expression": "",
            "Value": "Items",
            "IsExpression": false,
            "Items": "Design|design\nDevelopment|dev\nMarketing|marketing\nSales|sales"
        },
        "TokenizeParameters": true,
        "LinkToFields": "",
        "IsRequired": "false",
        "FieldIdTokenName": ""
    }
}

Revised 09/25/2026