Configure form rules to control field visibility

Form rules let you control how form fields display to visitors based on their input. You can define dependencies between fields so that you show or hide specific elements when certain conditions are met.

Use form rules to create cleaner and more responsive forms:

• Personalized user experiences – Display only relevant questions to visitors, reduce clutter, and improve completion rates.
• Intuitive configuration – Configure conditions directly in the form builder user interface (UI) with support for multiple conditions (AND/OR logic) and comparison types, such as Equals, Not equals, Contains, and Regular expression.

How form rules work

A rule controls the visibility of one specific form field (the target element) based on the value of one or more other fields.

For example, you may want to display a State/Province field only when the visitor selects United States or Canada in the Country drop-down list. Configure conditions that evaluate the Country field, and when those conditions are met, the system shows the State/Province field.

Open the form rules dialog

1. Create or open a form in the form builder.
2. Add the required form elements.
3. Open the element’s context menu.
4. Select Form Rules.

The Form Rules tab opens, where you can create and manage rules.

Configure a rule

When you create or edit a rule, configure the following fields.

Target element

The Target Element is the form field whose visibility the rule controls.

• The drop-down lists eligible form fields from the current form.
• The system excludes fields already used as target elements in other rules.
• The system automatically hides fields that would create circular dependencies.
• The drop-down list includes standard form elements that the form builder supports.

Visibility

Visibility determines what happens to the target element when the rule conditions evaluate to true:

• Show – The element is visible to the visitor.
• Hide – The element is hidden from the visitor.

If (condition combinations)

If you add multiple conditions, choose how the system evaluates them:

• All – Logical AND. All conditions must be true.
• Any – Logical OR. At least one condition must be true.

Each condition checks the value of another form field.

Element

The Element is the form field whose value the rule evaluates. Condition elements support fields that accept input values, such as:

• Text field
• Textarea
• Number
• URL
• Range
• Selection fields
• Choice fields

Operator

The Operator defines how the system evaluates the element’s value. Operators include:

• Not applicable
• Match regular expression
• Equals
• Not equals
• Contains
• Does not contain
• Starts with
• Ends with

Value

Enter the Value to compare against when using comparison Operators.

📘

Note

Do not create rules that form a circular dependency between fields. A circular dependency occurs when fields depend on each other in a loop, preventing the form from resolving which field should be shown.

For example, a longer loop may involve three or more elements:

• Field A depends on B
• Field B depends on C
• Field C depends on A

In this scenario, showing A requires B, showing B requires C, and showing C requires A. Because each field depends (directly or indirectly) on another in the same loop, the form cannot evaluate the rules correctly.

To ensure predictable behavior, configure rules so dependencies always flow in one direction and never form a closed loop.

Key behavior

• Each rule applies to only one target element.
• A form can contain multiple rules, each operating independently.
• The system does not save changes automatically. Click Save to persist rule changes.

Preview form rules

Preview rule behavior directly in Visual Builder edit mode.

• You need a delivery site that supports form rendering to preview rule behavior.
• You can find a reference delivery site implementation in the Visual Builder Forms repository.
• Test different inputs to confirm that fields display or hide as expected.

For example, in the earlier scenario:

• Select United States or Canada in the Country field.
• Verify that the State/Province field displays based on the configured rule.