Add Tags Input

Audience: Low-code Engineers

Skill Prerequisites: Forms, Tokens

Adds a tags input, where users enter several values as tags with suggestions from a data source, to a Dynamic Field Container when the form loads. It works like a Tags Input 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 add keywords or labels to a record
• Pick several people or items with type-ahead suggestions

Don't use it to

• Make the field required or styled. This action doesn't have Is Required, validators or CSS settings. Use Add Dropdown with Checkboxes if you need them.

Related Actions

Action Name	Description
Add Dropdown with Checkboxes	Lets users tick several options in a dropdown.
Add Dropdown with Autocomplete	Lets users search for one option.

Input Parameter Reference

This action has the common parameters, except Secure Input, Readonly, the CSS settings, Is Required, Validation Condition, the custom validators and Tokenize Validators?. It has the list parameters, except Link To, and also:

Parameter	Description	Supports Tokens	Default	Required
Limit Number of Tags	The most tags a user can enter. 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 tag values separated by commas. See Values of list fields.

Examples

tip

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

1. Add a keywords field

Add this action to the form's On PreInit or On Init actions. It adds a keywords field with suggestions to the ExtraFields container, allowing up to five tags.

{
    "Title": "Add Tags Input",
    "ActionType": "AddTagsInputField",
    "Description": "Add the keywords field",
    "Condition": null,
    "Parameters": {
        "ContainerId": "ExtraFields",
        "FieldId": "Keywords",
        "FieldName": "Keywords",
        "InitialValue": "",
        "Limit": "5",
        "DataSource": {
            "Expression": "",
            "Value": "Items",
            "IsExpression": false,
            "Items": "Urgent\nBilling\nTechnical\nFeedback"
        },
        "TokenizeParameters": true,
        "FieldIdTokenName": ""
    }
}

Revised 09/25/2026