Form Input

About Form Input

The Form Input node is used to collect structured user input data inside a workflow.

It allows the workflow creator to build a custom form and assign each submitted value to a workflow variable. Those variables can then be used in later steps, such as AI nodes, worker nodes, routing logic, or other user-facing steps.

How Form Input works

When the workflow reaches this node, the end user is shown the configured form.

The form can include one or more fields, each mapped to a workflow variable. When the user submits the form, the entered values are saved and made available for later steps in the workflow.

If Show Cancel Button is enabled, the node also includes a cancel path that can be connected separately.

Settings

The node currently includes the following settings:

Node Name
Description
Form Title
Form Subtitle
Form Fields
Submit Button Text
Cancel Button Text
Show Cancel Button

If Show Cancel Button is enabled, the node also includes a Cancel output path.

Form Fields

Each form field is configured individually inside the node.

The current field settings are:

Variable Name
Label
Type
Placeholder
Required field
Overwrite existing variable

Example field setup

A typical field can be configured like this:

Variable Name: firstName
Label: First name
Type: Text
Placeholder: Enter your first name

Variable Name

The Variable Name defines which workflow variable the submitted value is saved into.

This is the variable name later nodes will use if they reference that value.

Type

The currently available field types are:

Text – Single-line text input
Email – Email address input with validation
URL – Web URL input with validation
Phone – Phone number input (validates based on visitor's location)
Dropdown – Selection from predefined options
Date – Date picker
Country – Country selection dropdown
Textarea – Multi-line text input
Currency – Numeric input for monetary amounts

Overwrite existing variable

If Overwrite existing variable is enabled, an existing value in that workflow variable can be replaced by the new form submission.

This is important when the same variable may already have been set earlier in the workflow. For example, an AI Set Variables node may already have extracted firstName from a passport or another uploaded document. If the form field also saves to firstName and Overwrite existing variable is enabled, the value entered in the form will replace the value that was extracted earlier.

This can be useful when the workflow should allow the user to confirm or correct a value. If it is not intended to replace an earlier value, Overwrite existing variable should be left disabled.

Output Paths

The node includes the following output paths:

Submit – User submitted the form with values
Cancel (only when Show Cancel Button is enabled) – User clicked the cancel button

Both paths can be connected to different next steps to handle form submission vs. cancellation differently.

Example Uses

The Form Input node can be used in many different ways depending on what the workflow needs to collect.

Examples:

collecting a customer reference number and saving it to a workflow variable for later use
collecting contact details such as email address or phone number when they are not available from earlier steps
collecting a merchant or business name before later verification or screening steps