Help

Chapters

Browse all chapters

Getting started

Editing

  • Pages
  • The page editor
  • Site header, footer and partials
  • Design and appearance
  • Media library
  • Blog

Site & domains

Billing & account

AI

FAQ

Help › Site & domains › Forms and submissions

Forms and submissions

Forms collect orders, questions and sign-ups from visitors. Every entry is stored under Forms, so nothing is lost even if an email goes astray.

Your forms

Forms lists each form with its slug, number of submissions, status and creation date. Click the submission count to read them.

ActionWhere
Switch a form off or onThe Active switch on its row. Switched off, visitors who send it get an error; saved submissions stay.
Edit fieldsThe form's name, or Edit
Preview, Settings, Analytics, Duplicate, DeleteThe row's ⋯ menu

Duplicate copies all fields and settings under a new name. Delete removes the form and all its submissions and cannot be undone.

A form's ⋯ menu: Preview, Settings, Analytics, Duplicate and Delete
A form's ⋯ menu: Preview, Settings, Analytics, Duplicate and Delete

Build a form

New sites come with a Contact Form and a Newsletter Subscription form. Build more in Forms → Create form.

  1. Name the form, for example "Cake order", and press Create.
  2. Click field types on the left to add them: Text, Email, Text area, Number, Phone, URL, Date, Time, Dropdown, Radio, Checkbox, File, Hidden, a Field group to group them under a title, or a Repeating group for rows visitors can add (see below).
  3. Open a field (the arrow on its row) to set its Label, placeholder, help text, Required field and validation rules. Reorder with the arrows or the grip.
  4. Press Save form, then Preview to try it. A preview checks your answers but saves and sends nothing.
  5. Place it on a page with the Contact Form section (Add section → Forms) and pick your form.
A four-field Cake order form: name and pick-up date are required
A four-field Cake order form: name and pick-up date are required

Repeating groups

A Repeating group lets a visitor add as many rows as they need, such as one row per guest or per cake on an order.

  1. Add a Repeating group and give it a label.
  2. Add its fields, up to 10. It holds simple fields only: no files, hidden fields or other groups.
  3. Set Minimum rows and Maximum rows (up to 20), and optionally Add button text, Remove button text and Row label. In the label, {n} is replaced by the row number.

Each entry's rows appear on its submission page, in the CSV export, in summary emails and in webhooks. If a group is set up wrongly, Save form says what to fix.

Form settings

Settings for a form sets the success message or a page to redirect to, the submit button text and style, and whether the form is active. Two options are on paid plans:

Email summaries and webhooks are available on paid plans
Email summaries and webhooks are available on paid plans
Form settings: General, After submission, Submit button, Email notifications and Webhook
Form settings: General, After submission, Submit button, Email notifications and Webhook
SectionFields
GeneralForm name, Slug, Description, Form is active
After submissionSuccess message, or a Redirect URL: a page, a web address, an anchor, a phone number or an email
Submit buttonButton text and style
Email notifications (paid)Email me a summary of new submissions and the address to Send to
Webhook (paid)See below

Changes show in a bar at the bottom of the page; press Save settings there.

Webhooks

A webhook sends each submission to another system (a CRM, a spreadsheet tool, Zapier) the moment it arrives. It needs a paid plan.

  1. Turn on Send submissions to a webhook.
  2. Enter the Webhook URL and choose POST or PUT.
  3. Optional: add Extra headers, such as an API key your system expects.
  4. Optional: press Generate for a Signing secret. Every request then carries an X-Webmarlin-Signature header your system can check.
  5. Optional: write a Body. Leave it blank to send the whole submission, or use {{field.name}}, {{submission.id}} and {{website.domain}}.
  6. Choose whether to Send spam submissions too, then Save settings.
  7. Press Send test. The page shows the status your endpoint answered.

Read submissions

Submissions lists every entry. Search and filter, open one to read it, Mark as spam or Not spam, archive or delete in bulk. Analytics charts submissions per day or week.

Submissions: search, filter by status, select rows for bulk actions
Submissions: search, filter by status, select rows for bulk actions

Opening a submission marks it Read. The page shows the answers, file uploads with Download, when it was sent, and the raw data. On paid plans it also shows the spam score and reason, and each Webhook delivery attempt with its result and timing.

One submission: the answers, when it arrived and the raw data
One submission: the answers, when it arrived and the raw data

Analytics

Analytics counts submissions for a date range: the total against the previous period, and how many are new, read and archived. The chart shows one bar per day (per week for long ranges).

Analytics for the last 30 days
Analytics for the last 30 days