Building a form

A form is a named collection of fields plus a bit of configuration — what the submit button says, what happens after submission, and whether you get notified.

Steps

1. Go to Forms and click New form.
2. Enter a Form name (e.g. "Contact us") and click Create. You land on the form's editor, with its status shown as DRAFT.
3. Set the top-level options:
   • Submit button label — defaults to "Submit" if left blank.
   • Success message — shown to visitors after they submit; defaults to "Thanks — we'll be in touch." if left blank.
   • Email me when this form receives a new submission — see Submission notifications.
4. Click Add field for each field you want — see Field types and conditional logic for what's available.
5. Click Save form.
6. Click Publish when you're ready for it to accept submissions.

A form is only reachable publicly once it's PUBLISHED — a DRAFT or ARCHIVED form's public endpoints (both fetching its schema and submitting to it) reject the request, so you can build and test a form privately before it's live. ARCHIVED is for retiring a form without deleting it (and its submission history).

Deleting a form

The Danger zone at the bottom of the form editor has Delete form — this removes the form and, since submissions belong to the form, its submission history along with it. There's no archive-then-recover path for submissions once a form is deleted; use ARCHIVED status instead if you might need the history later.