DOCUMENTATION

Email Signup Form

Last updated May 2026
Media Block
All plans

An embeddable subscription form that collects email addresses (and optional extra fields) into one of your contact lists. Fully configurable layout, fields, and copy. Add with /email signup or /subscribe.

Layouts

Six layout presets are available in the settings panel — Card, Inline, Minimal, Hero, Banner, and Float. Each renders the same underlying form with different framing; switching layouts doesn't lose any configured fields or copy.

Fields

Email is always present and required. Beyond that you can add any combination of the following field presets, each with an editable label and placeholder:

FieldDefault placeholder
Emailyour@email.com
NameYour full name
First nameFirst name
Phone+1 (555) 000-0000
CompanyCompany name
CustomYour answer

Any field can be marked required except email, which is always required.

Other settings

title / subtitle / buttonText
The form’s copy — shown above the fields and on the submit button.
eyebrow
Small label shown above the title — only visible in the Hero layout.
accentColor
Controls the button and focus-state color, picked from a swatch palette.
listId
The contact list new subscribers are added to. Left empty, submissions still record but aren’t added to a list.
redirectUrl
Optional URL to redirect to after a successful submission, instead of showing the default success state in place.

How submission works

The form needs to accept submissions from anonymous visitors, not just you — so it doesn't use your normal authenticated session. Instead, the editor fetches a signed, document-scoped submission token once (cached in the block's metadata) and the public form sends that token along with each submission. A Public ready / Token pending indicator in the editor shows whether that token has been issued yet.

The signup form won't accept submissions on a published page until the page has been published at least once after the block was added — that's what issues the signed token.

Publishing

Renders the configured layout on the published page and posts submissions to the signup endpoint using the signed token. In the editor, submitting instead goes through your authenticated session directly — useful for testing without needing to publish first.