Skip to content

Form Designer — Section Breaks

Section Breaks are container elements in the Versaa Form Designer. They group UI elements together so that a related set of form fields can be organised visually and controlled as a unit.

What Section Breaks are for

  • Grouping — place related form items (text boxes, labels, date fields, etc.) inside a section so they appear as a logical block.
  • Visibility control — apply a Visible formula to the Section Break itself rather than to each individual item inside it. When the section is hidden, all contained elements are hidden. This is the recommended pattern for conditional blocks.
  • Layout — sections create a distinct visual container in the mobile UI.

Access Permissions

To see Form controls (including Section Breaks) in Management Studio you must have the correct permissions. Specific forms are enabled on a per-user basis — contact your admin controller to ensure you have access.

Adding a Section Break

In Management Studio Forms Designer:

  1. Open the form in the designer.
  2. In the left-hand toolbox/element list, locate Section Break.
  3. Drag the Section Break onto the form canvas at the desired position.
  4. Drag the form items you want to group into the Section Break container.
  5. Optionally, set a Visible formula on the Section Break to control the whole group.

Visibility Pattern

This is the standard pattern — one formula on the section hides/shows multiple fields at once:

# On the Section Break's Visible property:
$formItem.SomeField == "Yes"

All items inside the section inherit the visibility of the section. You do not need to add a Visible formula to each individual item.

For the three-tier debug visibility pattern (always-visible debug section, conditionally-visible sections, and fully-hidden sections), see visibility-formulas.md.