Skip to main content

Conditional visibility

Show or hide fields based on other answers, list columns, and comparison operators.

Video coming soon

Conditional visibility

id: academy-conditional-visibility · ~2–4 min

Record this lesson video, then set src on <LessonVideo id="academy-conditional-visibility" />.
Form preview · conditionals

Describe the follow-up

Example: answering Yes reveals the follow-up field.

Audience: Admin

Conditional visibility lets you show a field only when another answer matches a rule. Hidden fields are skipped on mobile and are not required while hidden. Rules are stored as Show only when… on each field (visibleWhen in the form definition).

Where to configure rules

Select a field on the Form Builder canvas and open Visibility Rules in the right panel—or use the Field visibility logic view to see which fields depend on others. Conditions control field visibility only; they do not route users between wizard steps.

Worked example

Suppose field A asks Issue type with options Leak, Electrical, and Other. Field B (Pipe diameter) should appear only when A equals Leak.

  1. Add both fields; place A above B in form order.
  2. Select B and add a visibility rule: source A, operator is, value Leak.
  3. Preview on mobile: choose ElectricalB stays hidden. Choose LeakB appears and can be marked required.

Add more rules on other fields the same way—for example show Other details when A is not Electrical.

Operators

OperatorTypical use
isExact match (text, number, date, yes/no)
is notHide unless the answer differs
is one ofMatch any value in a list
is none ofHide when answer is in a list
has any valueShow when the source was answered
is emptyShow when the source is blank
is not emptyShow once the source has data
is greater than / is less thanNumeric comparisons only

Pick an operator that matches the source field type. Numeric comparisons require a number source.

Sources: form fields and list columns

The Source can be:

  • Any earlier form field (text, number, date, radio, checkboxes, list selection, etc.).
  • A column from a List field bound to a Data Source—for example show Warranty notes when @equipment.category is one of Premium, Extended.

List-column sources read the value from the row the user selected. If the list is cleared, dependent fields hide again.

Behavior at runtime

Rules re-evaluate as the user types or changes selections. Clearing the controlling answer hides dependent fields and clears their validation state. Put controlling questions above the fields they unlock so the flow reads naturally on mobile.

Tips

  • Keep chains shallow—one or two hops (A → B → C)—so testers can predict what appears.
  • Do not mark a hidden field as required unless it can become visible in the same visit.
  • When renaming field slugs, reopen visibility rules to confirm sources still resolve.
  • Combine with Lists from Data Sources to drive visibility from catalog columns.