Subscription Forms
Grow your list with signup forms you embed on your own site. New subscribers land straight in your GoodPostal contacts, in the groups you choose.
Creating a Form
- 1
Create the form
Go to Forms in your workspace and click Create Form. Name it for the place it will live (e.g., "Blog footer", "Homepage"). - 2
Choose the fields and groups
Pick which fields to ask for (email is always included) and which contact groups new subscribers join automatically. - 3
Style it
Adjust colors, button text, and the success message so the form matches your site. - 4
Embed it
Open the Embed view and copy the snippet that fits how your site is built.
Embed Options
Each form offers several embed styles:
- JavaScript widget - One script tag that renders the form and handles submission for you. The easiest option for most sites.
- Styled HTML - A self-contained HTML form with inline styles. No JavaScript required.
- Simple HTML - Bare markup with CSS class hooks, for sites that want full control over styling.
- Headless - A documented POST endpoint for custom-built forms and single-page apps.
JavaScript widget example
html
<div data-goodpostal-form="YOUR_FORM_ID"></div>
<script src="https://goodpostal.com/js/embed.js" data-api-base="https://goodpostal.com" async></script>Note
The exact snippet, including your form ID and API base, is generated for you on the form's Embed page. Copy it from there rather than building it by hand.
Where Subscribers Land
What happens on submit depends on the opt-in type you chose when you built the form:
- Single opt-in - The contact is created or updated right away, added to the groups configured on the form, and is ready for your next campaign.
- Double opt-in - The submission is held as pending and GoodPostal emails a confirmation link. Nothing is added to your contacts or groups until the subscriber clicks that link.
New forms default to double opt-in. You can switch a form to single opt-in while building it.
The Forms list shows a submission count for each form, and every confirmed subscriber appears in Contacts.
Note
Someone who previously unsubscribed is not resubscribed by a single opt-in form, and is not added to the form's groups. Their choice to leave your list stands until they opt back in themselves.
Spam Protection
Form endpoints are rate limited, and submissions are validated server-side. Pause a form at any time with its active toggle; a paused form stops accepting submissions without you touching your site.