Docs / Forms & Automation
Building a form
A complete, field-by-field walkthrough of the Form widget.
Drag the Form widget onto any page (it drops into a Container like every other widget). Its Content tab is organised top to bottom as: the Form Fields list, Submission, Confirmations, Behavior, Pages & Steps (only once the form has more than one page), Quiz Mode, and Spam Protection — this article walks through the essentials, with dedicated articles linked for the rest.
Adding and configuring fields
- 1In the Form Fields repeater, click Add Field.
- 2Set Field Type first — the rest of the settings shown below it change to match (a Rating field shows a max-rating setting; a Range Slider shows min/max/step; and so on). See "Field types reference" for the full list.
- 3Set the Label — this is the question text visitors see. The field's internal name (used everywhere you'd reference it — conditional logic, expressions, email merge tags, workflow steps) is generated automatically from the Label by slugifying it, e.g. "What's your budget?" becomes what_s_your_budget. Renaming the Label later keeps regenerating the name automatically, right up until you've referenced that field elsewhere — at that point, treat the Label as fixed to avoid breaking an existing reference.
- 4Toggle Required and Read Only as needed, and add a Description for helper text shown under the label.
- 5Switch to the field's Conditional Logic tab to make it show only when earlier answers match a rule — see "Conditional logic."
Each field's row in the list shows its type next to the label once collapsed — e.g. "Budget — Range Slider" — so a long field list stays scannable without opening every row. Reorder fields by dragging a row's handle, or with the up/down arrows in its header.
Splitting a form into pages
Open any field's Advanced tab and turn on Start a New Page Here — that field and everything after it (down to the next page break) becomes the next page. As soon as a form has two or more pages, the field list shows a thin "Page 2", "Page 3"… divider above each page's first field, and a Pages & Steps section appears in the Content tab with every page's title, description and visibility, the progress bar and the navigation settings. See "Multi-step forms" for the full walkthrough.
- Behavior → Step Mode — Pages (the default, using Start a New Page Here), One field per step, or Everything on one page.
- Behavior → Validation Mode — On Next Page/Submit (default), On Value Change (instant, as the visitor types), or On Submit Only (no per-page checks at all).
Saving submissions
Save Submission to Database is on by default and writes every entry to Craftor → Entries, where you can view, edit, export, or delete submissions individually or in bulk. Its own description points at the real mechanism for anything beyond storage: "For email, webhooks, Mailchimp, Slack automation use Craftor → Workflows" — see "Email notifications" and "Workflows & automations." Turning this off doesn't disable notifications or workflows; it only stops writing a row to the Entries table, useful for a form you never intend to review manually.
Confirmations
The "On Submit, Show" repeater controls what a visitor sees immediately after submitting — a Message shown in place of the form, or a Redirect to another URL. Multiple confirmations can coexist, each gated by its own "Only Show If" condition; the first one (top to bottom) whose condition matches wins, so put your specific branches above a single catch-all entry with no condition left at the bottom. See "Conditional logic" for how to branch this by answer.