Add Dropdown with Autocomplete

Audience: Low-code Engineers

Skill Prerequisites: Forms, Tokens

Adds a searchable dropdown to a Dynamic Field Container when the form loads. Users type to filter the options, which makes it suitable for long lists. It works like a Dropdown with Autocomplete 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 pick a customer, product or employee from a long list
• Search options loaded from a database query

Don't use it to

• Offer a handful of options. Use Add Dropdown or Add Radio Boxes instead.
• Make the list depend on another field. This action doesn't have Link To. Use Add Dropdown instead.

Related Actions

Action Name	Description
Add Dropdown	Adds a plain dropdown.
Add Tags Input	Lets users pick several values with suggestions.

Input Parameter Reference

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

Parameter	Description	Supports Tokens	Default	Required
Message for no results	The text shown when nothing matches the search. HTML is allowed.	Yes	No results found	No
Number of items	How many options are loaded at a time. More load as the user scrolls.	Yes	50	No
Disable dropdown on click	Enter true to show the options only after the user starts typing, instead of when the field is clicked.	Yes	false	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, the selected value is available in [<FieldId>].

Examples

tip

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

1. Add a searchable customer list

Add this action to the form's On PreInit or On Init actions. It adds a customer picker to the ExtraFields container, with options from a SQL query.

{
    "Title": "Add Dropdown with Autocomplete",
    "ActionType": "AddDropdrownWithAutocomplete",
    "Description": "Add the customer picker",
    "Condition": null,
    "Parameters": {
        "ContainerId": "ExtraFields",
        "FieldId": "Customer",
        "FieldName": "Customer",
        "InitialValue": "",
        "NoResults": "No matching customers",
        "DisplayNumber": "50",
        "DisableDropdownOnClick": "false",
        "DataSource": {
            "Expression": "",
            "Value": "SQL Query",
            "IsExpression": false,
            "ConnectionString": "",
            "QueryTimeout": "",
            "TokenizeText": false,
            "SqlQuery": "SELECT CompanyName AS Text, CustomerId AS Value FROM Customers ORDER BY CompanyName"
        },
        "TokenizeParameters": true,
        "IsRequired": "true",
        "FieldIdTokenName": ""
    }
}

The action type ID is spelled AddDropdrownWithAutocomplete in the product.

Revised 09/25/2026