DocsGrow your audience

Signup forms

A hosted signup page and an embeddable form, with custom fields and spam protection built in.

Collect readers with a hosted page, an embedded form on your own site, or the API. All three follow your double opt-in setting, and new readers can enter your welcome series automatically.

Hosted signup page

Every newsletter has a ready-made signup page at /p/{your-slug}/subscribe, also reachable on your custom domain. On the Forms page you can set its title, description, a consent line, the message shown after signing up, and the fields it asks for. You can also switch it off.

Embed on your site

The Forms page generates an HTML snippet for your newsletter. Paste it anywhere HTML is allowed and style it with your own CSS. It looks like this:

Embed snippet (shortened)HTML
<form action="https://newsletter.sh/api/subscribe" method="post" data-nsh-form>
  <input type="hidden" name="newsletterSlug" value="field-notes">
  <input type="hidden" name="startedAt" value="">
  <!-- Honeypot: hidden from people, irresistible to bots -->
  <div style="position:absolute;left:-9999px" aria-hidden="true">
    <input name="website" tabindex="-1" autocomplete="off">
  </div>
  <input type="email" name="email" required placeholder="you@example.com" aria-label="Email">
  <input name="fields[company]" placeholder="Company" aria-label="Company">
  <button type="submit">Subscribe</button>
  <p data-nsh-msg role="status"></p>
</form>
<script>/* small inline script, copied from the Forms page */</script>
  • With the inline script, the form submits in the background and shows “Check your inbox to confirm.” or “You're subscribed.” in place.
  • Without JavaScript it still works: the browser posts the form and the reader lands on your hosted page with the result.
  • The script also sends the page the form sits on, the referrer and the reader's time zone, so you can see which page converts and deliver at their local time.

Custom fields

Ask for up to 10 extra fields, each with a label and an optional “required” flag. Answers are saved as custom fields on the subscriber, ready to use as merge fields. In the embed they are named fields[key]. The keys email and name are reserved.

Spam protection

Signup forms are a favourite target for bots. These protections are always on:

Signup form protections
ProtectionWhat it does
HoneypotA hidden field people never see. If it is filled in, the request gets a fake success and nothing is saved.
Speed checkA form submitted less than two seconds after it loaded is treated the same way.
Rate limitsAt most 10 sign-ups an hour from one IP address and 200 an hour per newsletter.
Double opt-inWith it on, nobody is mailed a campaign until they confirm from their own inbox.
SuppressionAddresses that bounced, complained or were suppressed by hand are never re-added.
newsletter.sh

Newsletters on your own sending account. Invite-only, sent through Amazon SES or the provider you already use.

© 2026 newsletter.sh