Fields reference
Every element you can add to a form, what it's for, and what you can configure.
This is a practical reference to the building blocks you place in the builder. Add elements from the palette, then select one to configure it in the right-hand inspector.
Input fields
| Field | What it's for | What you can set |
|---|---|---|
| Text | Short free-text answers | Placeholder · Required (+ custom error message) |
| Text area | Longer free-text answers | Placeholder · Rows (1–20) · Required (+ error) |
| Email capture, with built-in email validation | Placeholder · Required (+ error) | |
| Phone | Phone capture with a country dial-code picker | Placeholder · Default country · Required (+ error) |
| Date | A date answer, via a date picker | Placeholder · Required (+ error) |
Every required field blocks the step until it's filled, and shows your error message (or "This field is required" if you leave it blank). Email, phone, and date formats are validated automatically.
Choice fields
| Field | What it's for |
|---|---|
| Single choice | Pick one option (radio-style) |
| Multiple choice | Pick several (checkbox-style) |
| Dropdown | Pick one from a select menu |
| Image choice | Pick from a grid of image tiles |
For single-, multiple-, and image-choice you can configure:
- Selection — toggle between Single and Multiple.
- Auto-advance on selection — for single-select, picking an option moves to the next step automatically (no submit button needed). On by default.
- Randomize option order — shuffles the options per visitor to remove order bias. (Your canvas always shows them in your editing order.)
- Layout — arrange options Vertical, Horizontal, or Grid.
- Add item — add options; edit each option's Label (its stored value is derived from the label automatically).
Dropdown is configured slightly differently: edit its Options inline (at least one is required) and set a placeholder.
Consent
The consent field handles marketing opt-in and disclaimers. Pick a Consent mode:
- SMS — a required checkbox with TCPA-compliant copy. Required is locked on (legally, SMS marketing needs explicit opt-in).
- Email — an informational disclaimer shown with email capture. No checkbox, and it isn't submitted as an answer.
- Custom — you control the copy and whether it's required.
Consent copy supports {{shop_name}}, {{terms}}, and {{privacy}}, which
resolve to your store name and your policy links at publish time. Set those links
in Settings → Legal & compliance, and
republish after
changing them.
Content
| Element | What it's for | Notes |
|---|---|---|
| Heading | A title (levels 1–4) | Edit text inline on the canvas; supports merge tags |
| Text block | Paragraph copy | Inline rich text; supports merge tags and policy links |
| Image | A picture, optionally linked | Set source, alt text, fit, position; per-breakpoint images |
Layout
| Element | What it's for |
|---|---|
| Container | Group elements to arrange them (row / stack / grid) and to enable floating |
| Spacer | Add vertical space between elements |
See Layout & responsive design for how containers unlock side-by-side and responsive layouts.
Actions & special
- Submit button — set its Text and Loading text, and choose what happens On submit: go to the Next step, Skip the step, or Redirect to a URL.
- Discount display — shows a static discount code for shoppers to copy (with an optional hidden copy button). Magic discounts don't need this element — they apply automatically.
Good to know
- Field names are automatic. Each answer is stored under a key (like
emailorshopping_interest) that Formtoro assigns; you edit the visible label, not the key. Those keys are what you'll see in Submissions and the Responses view. - A few controls aren't exposed yet. Minimum/maximum selections on choice fields and minimum/maximum dates exist in the data model but don't have builder controls today — treat them as planned, not hidden.
Next steps
- Building forms — placing and arranging these elements.
- Logic engine — show, hide, and branch based on answers.