Divider block

Use a divider block to separate sections of a form. It displays a plain line or an optional label and does not collect an answer.

Configuration

Property	Type	Required	Default when omitted	Allowed values / range	What it does
`type`	string	yes	n/a	`divider`	Selects the block
`copy`	string	no	none (a plain line)	Any text. Supports `{{field}}` piping	Optional label shown on the divider
`visible_if`	condition array	no	none (always shown)	Same as on fields	Show the block only when the condition is true
`hide_if`	condition array	no	none (never hidden)	Same as on fields	Hide the block when the condition is true

The block collects no submission value.

Visibility

A divider is visible when visible_if is true or absent, unless hide_if is true. A true hide_if hides the divider even when visible_if is true. An empty visible_if array evaluates to false, so it hides the divider.

Labels and piping

In copy, use {{field_name}} to display a field's answer. If there is no answer, piping uses the matching hidden-field value; if that is also missing, it displays an empty string. Array answers display as comma-separated values.

Where you can use it

Place a divider in the ui array on the start page, a question page, or an ending. End pages accept display blocks only.

Example

This divider labels the questions that follow it. It appears when plan is Business and includes the respondent's company name.

{
  "mode": "page",
  "pages": [
    {
      "type": "form",
      "id": "p1",
      "ui": [
        {
          "type": "short_text_input",
          "name": "company_name",
          "label": "Company name"
        },
        {
          "type": "single_select",
          "name": "plan",
          "label": "Plan",
          "options": ["Starter", "Business"]
        },
        {
          "type": "divider",
          "copy": "Billing for {{company_name}}",
          "visible_if": [
            { "field": "plan", "operator": "equals", "value": "Business" }
          ]
        }
      ]
    }
  ]
}