CALIPRY

Form builder field reference

Last checked against Splash 1.0.0 / 2026-08-15

The Form builder section builds both the quote request form and the contact form. Each field is a block. This page lists every block type, the settings it carries, the settings it does not, and the default for each.

The section can be added to any template and it ships with a preset, so you can add it back if you delete it. For the steps of assembling a form, see building the quote request form. For the conditional pair, see conditional form fields.

Section settings

These apply to the whole form. They are listed here in the order they appear in the theme editor.

Caption

A short line at the top of the form card, above the form heading, set in capitals beside the ruler mark. No default.

Form heading

A heading inside the form card, above the first field. No default. The card head is hidden entirely when both this and Caption are empty.

Heading

The page heading above the form. Default Contact us. On a page template the page's own title is used and this is only the fallback; on every other template this is the heading.

Page caption

A short line above the page heading, set in capitals beside the ruler mark. No default. The mark prints whether or not you type anything here.

Button label

The submit button. Default Send message. Emptied, the button reads Send.

Fine print under the button

One line centered below the submit button, for a reply time or a no-obligation note. No default. Nothing prints when it is empty.

Success message

The wording on the confirmation panel that replaces the form after a send. Default Thanks for reaching out. We answer within one business day. Emptied, the theme's own wording is used instead.

On a page template the section also prints a breadcrumb row above the heading, because on that template it owns the page's only heading.

The settings matrix

Which settings exist on which field type, with the default beside the ones that have one. No means the setting is not offered on that type, so it cannot be changed and the behavior described under the type below is fixed.

Field type Label Help text Placeholder Unit Required Width Choices Select the first choice by default Autofill Conditions
Text Yes Yes Yes Yes Yes, off Yes, full No No Yes, off Yes
Email Yes Yes Yes No Yes, on Yes, full No No No Yes
Phone Yes Yes Yes No Yes, off Yes, full No No No Yes
Number Yes Yes Yes Yes Yes, off Yes, full No No No Yes
Date Yes Yes No No Yes, off Yes, full No No No Yes
Paragraph text Yes Yes Yes No Yes, off No No No No Yes
Dropdown Yes Yes No No Yes, off Yes, full Yes Yes, off No Yes
Multiple choice Yes Yes No No Yes, off No Yes Yes, off No Yes
Checkboxes Yes Yes No No No No Yes No No Yes
Checkbox Yes Yes No No Yes, off No No No No Yes
Section break Heading Yes No No No No No No No Yes

The three narrative blocks (Contact method, Opening hours, Callout) are not in this table. They are not fields, they carry none of these settings, and they are covered further down.

What each setting does

Label

The words above the control, and the field's identity everywhere else. It is the column name the answer arrives under in your notification email, and it is the exact string another field types into Show when this field to depend on it. A field with no label does not render on the storefront at all; in the theme editor you see a dashed box telling you to name it. Square brackets are stripped out of the email column name. Two fields sharing a label arrive as Label and Label (2), and a condition naming that label watches the first of the two.

Help text

One line of guidance. It hangs below the control on Text, Email, Phone, Number, Date, Paragraph text, Dropdown and Checkbox. On Multiple choice and Checkboxes it sits above the options instead, because it explains the choices. On a Section break it is the paragraph under the heading.

Placeholder

Grey text inside an empty field. It disappears as soon as anything is typed, so it is not a substitute for a label or for help text.

Unit

A measure such as ft or kg, printed inside the field at its trailing edge in the data face. It is also appended to the answer's name, so a field labeled Pool length with unit ft arrives in your email as Pool length (ft). Screen readers announce it. On a Number field, setting a unit removes the browser's up and down arrows, because they are drawn in the same place; a Number field with no unit keeps them.

Required

The visitor cannot send the form without answering. Off by default everywhere except Email, which ships on. A field that is not required prints (optional) after its label. A conditional field is required only while it is visible.

Width

Full width or Half width, defaulting to Full width. Two Half width fields pair on one line from 750px up. Below that every field is full width, so two halves stack on a phone.

Choices

One choice per line. Blank lines are ignored. The text you type is what the visitor reads, what arrives in your email, and what a condition must match, so copy it exactly when writing a condition.

Select the first choice by default

Starts the field on its first choice rather than unanswered. Off by default.

Autofill

Lets the browser fill the field from the visitor's saved details. Off, Full name, Company, Street address, Postal code or Country. Off by default, and offered on Text fields only.

Show when this field / Has one of these answers

The conditional pair, present on every field type and on Section break. The first takes the Label of another field on this form, typed exactly; the second takes the answers that reveal it, one per line. Both halves are needed. See conditional form fields.

Field types

Text

A single-line box. The only type that offers Autofill, and one of two that offer Unit. Use it for names, addresses, site references and anything short that is not a number.

Email

A single-line box validated as an email address, always autofilled as one, with spellcheck and auto-capitalization off. Label defaults to Email and Required ships on.

Note The first Email field that is not conditional supplies the reply-to address on the message Shopify sends you, and it is the one field prefilled for a signed-in customer. Always keep one Email field that no condition can hide.

Phone

A single-line box marked as a telephone number, which raises the numeric keypad on a phone and autofills from saved details. Label defaults to Phone. There is no format checking: whatever the visitor types is what you receive.

Number

Accepts numbers only. Drawn in the monospace data face with tabular figures, the same register prices and specifications use. Setting a Unit removes the browser's stepper arrows.

Date

Opens the browser's own date picker, so there is no Placeholder to set. Also drawn in the monospace data face. The date arrives in your email in the format the browser submits, which is year, month, day.

Paragraph text

A five-row box for free writing. Always full width: there is no Width setting, because a half-width paragraph box is too narrow to write in.

A single answer from a list. With Select the first choice by default off, the list opens on a Select an option prompt row and Required forces a real answer. Turning it on selects the first choice and removes the prompt row, so there is no way back to unanswered. That is right for a branch selector at the top of a form and wrong for an optional question.

Multiple choice

A single answer from a set of boxed radio buttons, all visible at once. Use it in place of a Dropdown when there are few choices and you want them read without a click. No Width setting: the options need the full measure.

Checkboxes

Several answers from one set. Every ticked choice arrives in your email under the field's label.

Limit Checkboxes has no Required setting, so its label always prints (optional) and the form can be sent with nothing ticked. If one of the choices has to be picked, use Multiple choice with Required on.

Checkbox

One box with the label beside it, for a consent line or a single yes-or-no question. Required makes ticking it a condition of sending. A ticked box arrives in your email as Yes. To use it as the controller of another field, type Checked into Has one of these answers; Yes and True also match, and nothing else does.

Section break

A heading and an optional paragraph across the full width of the form, for dividing a long form into parts. Its first setting is labeled Heading rather than Label. It submits nothing and asks nothing.

A Section break can carry a condition, so a whole part of the form can appear only after a particular answer. It cannot be the field another field depends on: naming a Section break in Show when this field matches nothing, and the field that names it stays permanently visible.

Narrative blocks

Three block types render in the column beside the form rather than inside it. They submit nothing, they carry no conditional settings, and each shows a note in the editor saying it appears beside the form.

The column appears only when the page has body content or at least one of these three blocks. With none of them and an empty page body, the form is centered on its own.

Contact method

A ruled row for one way of reaching you. Add several and they stack as a ruled list.

Icon

A fixed list: None, Phone, Email, Location, Clock, Verified, Shipping, Returns, Warranty, Secure payment, Box. Defaults to Phone. Choosing None drops the mark and the row starts at the text.

Caption

The small label above the value, such as Phone or Showroom. Defaults to Phone.

Value

The number, address or line itself. Nothing prints when it is empty.

Link

Optional. Turns the value into a link. Use tel: for a phone number and mailto: for an email address.

Note

Optional. One quieter line under the value, for a qualifier such as opening days or a response time.

Opening hours

A two-column table of days and times, with the times set in the data face and aligned on their trailing edge so the figures line up.

Caption

The heading above the table. Defaults to Opening hours.

Rows

One row per line, written as the day, a vertical bar, then the hours. Blank lines are skipped. Until you type a row, the block is its caption alone.

Monday to Friday | 08:00 - 18:00
Saturday | 10:00 - 16:00
Sunday | Closed

The vertical bar is what splits the two columns. A line with no bar prints the whole line as the day and leaves the hours empty.

Callout

A short panel with an optional button, for sending someone somewhere other than this form.

Caption

The heading. Defaults to Looking for something else?

Text

One line under the heading.

Button label

Defaults to Learn more.

Button link

Where the button goes. No default.

Note The button needs both a label and a link. Fill in one and leave the other empty and no button appears, with nothing in the editor to say why.

Where they render

These three ignore where you drag them in the block list. The column is always drawn in this order:

  1. The page's own body content, from the page in Shopify admin.
  2. Every Contact method block, in block order, as a ruled list.
  3. Opening hours and Callout, in block order, side by side from 600px and stacked below that.

Dragging a Callout above a Contact method changes nothing on the storefront. Reordering within a kind does work: two Contact methods appear in the order they sit in the list.

Limits and rules

50 blocks

The section takes 50 blocks in total. Contact method, Opening hours, Callout and Section break all count against it, so a form with a long narrative column has fewer fields available.

The Label is the key

It names the field on the page, names the answer in your email, and is what a condition matches on. Renaming a field breaks every condition that points at it and splits your records across two column names.

An unlabeled field is not on the page

It renders nowhere on the storefront. If a field is missing from the live form and present in the editor, check its Label first.

Answers arrive by email

The form posts through Shopify's own contact form, so answers go to the store contact address as an email, under the labels you typed. Nothing is stored in the admin.

The section ships with three preset blocks: a Text field labeled Name (required, half width, autofilling a full name), an Email field labeled Email (required, half width), and a Paragraph text field labeled Your message (required). Delete or edit them like any other block.

Something wrong here If a step does not match what you see, say so and it gets fixed. Documentation goes stale, which is why the line under the title carries a date.