Add Textbox

Audience: Low-code Engineers

Skill Prerequisites: Forms, Tokens

Adds a single-line text box to a Dynamic Field Container when the form loads. It works like a Text Box 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 a question for each item in a list, for example a comment for each product in an order
• Add fields that only some users need, for example a VAT number for business customers

Don't use it to

• Collect several lines of text. Use Add Large Text instead.
• Collect numbers. Use Add Number Input instead.

Related Actions

Action Name	Description
Add Large Text	Adds a multi-line text area.
Load dynamic field from JSON	Adds several fields at once.

Input Parameter Reference

This action has all the common parameters, including Secure Input and Readonly, and no others.

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 entered text is available in [<FieldId>].

Examples

tip

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

1. Add a required VAT number field

Add this action to the form's On PreInit or On Init actions. It adds a required VAT Number text box to the ExtraFields container.

{
    "Title": "Add Textbox",
    "ActionType": "AddDynamicTextBox",
    "Description": "Add the VAT number field",
    "Condition": null,
    "Parameters": {
        "ContainerId": "ExtraFields",
        "FieldId": "VatNumber",
        "FieldName": "VAT Number",
        "FieldDescription": "As shown on your invoices",
        "InitialValue": "",
        "SecureInput": true,
        "IsRequired": "true",
        "FieldIdTokenName": ""
    }
}

Revised 09/25/2026