Text and headings

Use text, h1, h2 and h3 blocks to show paragraph text or headings. Their copy can include values piped from other fields.

What these blocks show

text shows paragraph text. The other types show headings. The first element of a page set as h1 is shown as the form title.

These blocks collect no answers, so they have no per-element submission value.

Where to use these blocks

Start pages and question pages accept ui elements. On question pages, ui holds fields and blocks in order. End pages hold display blocks only.

Properties

Property	Type	Required	Default when omitted	Allowed values / range	What it does
`type`	string	yes	n/a	`text`, `h1`, `h2` or `h3`	Selects the block.
`copy`	string	yes	n/a	Any text. Supports `{{field}}` piping.	Text to show. For `h1`, the first element of a page set as `h1` is shown as the form title.
`hideEmptyVariableLines`	boolean	no	`false`	`true`, `false`	When `true`, drops lines where every piped variable is empty.
`visible_if`	condition array	no	none (always shown)	Same condition syntax as fields. An empty array hides the block.	Shows the block only when the condition is true.
`hide_if`	condition array	no	none (never hidden)	Same condition syntax as fields.	Hides the block when the condition is true.

A block is visible when visible_if is true or absent and hide_if is not true.

Piped values come from a field’s answer; if there is no answer, piping uses a hidden field with that name, or an empty string. Declare hidden fields in form settings with hidden_fields, separately from the form config. Array answers appear as comma-separated values. Calculation answers use their explicit decimalPlaces, or up to two decimals with trailing zeros dropped when no value is set. Piping does not apply a calculation’s prefix or suffix. Pipe names support letters, digits and underscores; names containing hyphens cannot be piped into text. In the editor preview, {{variables}} appear as written.

JSON example

[
  {
    "type": "short_text_input",
    "name": "first_name",
    "label": "First name"
  },
  {
    "type": "short_text_input",
    "name": "company_name",
    "label": "Company name"
  },
  {
    "type": "h1",
    "copy": "Welcome, {{first_name}}"
  },
  {
    "type": "text",
    "copy": "Tell us about your project.\nCompany: {{company_name}}",
    "hideEmptyVariableLines": true
  },
  {
    "type": "h2",
    "copy": "Project details"
  },
  {
    "type": "h3",
    "copy": "Your goals"
  }
]