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

  1. 1In the Form Fields repeater, click Add Field.
  2. 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.
  3. 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.
  4. 4Toggle Required and Read Only as needed, and add a Description for helper text shown under the label.
  5. 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.