Docusaurus newsletter form
Add a release-notes signup to your Docusaurus site with no plugin. One email field pasted into an MDX page, and subscribers land in your inbox or your email tool. No backend of your own.
How to build it
- Create a form in your Formpaste dashboard and copy its access key.
- Paste the markup into your changelog or landing page and rename class to className.
- Replace YOUR_ACCESS_KEY_HERE with your access key, then deploy.
Docusaurus gotchas
Docusaurus pages are MDX, so a Formpaste form is markup you put straight in the doc. There is no plugin to install and no theme to swizzle. The one catch is that MDX treats markup as JSX, so the pasted snippet needs className instead of class.
MDX is JSX, so use className
In an .mdx file anything that looks like HTML is actually JSX. Rename class to className on the pasted form, and write any inline style as an object like style={{marginTop: '1rem'}} rather than a string. The unstyled CSS snippet is the easiest one to adapt.
No plugin and no swizzling
You do not need a Docusaurus plugin, and you do not need to swizzle a theme component. A form in the page body works in docs, in the blog, and on standalone pages alike.
Move it to a component when it repeats
If the same form belongs on many pages, put it in src/components/ as a .jsx or .tsx file and import it into each doc. That is the pattern the Docusaurus docs recommend for anything beyond a one-off, and it keeps the markup out of your prose.
Keep the hidden access_key
Leave the generated hidden access_key input in place so Formpaste knows which form the submission belongs to. It is a normal input, so it survives the move into a component unchanged.
What to get right
One field converts best
A newsletter form should ask for email only. Every extra field lowers signups.
Confirm before you celebrate
Show a subscribed message on success. If you need double opt-in, send the confirmation from your email tool, not the form.
Push to your email tool
Forward submissions to your ESP with a webhook so new subscribers land where you send campaigns.
How it works
Three simple steps for form submissions to land in your email inbox.
Create your form, set your form's action URL to Formpaste's endpoint, and add your access key.
Create your form
Sign up, verify your email, and create an access key in your dashboard.
Copy the code
Paste the snippet above into your project. Pick CSS or Tailwind to match your site.
<form action="https://api.formpaste.com/submit" method="POST" class="mx-auto flex w-full max-w-md flex-col gap-4 rounded-xl border border-gray-200 bg-white p-6 shadow-sm dark:border-gray-800 dark:bg-gray-950">
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Email
<input type="email" name="email" placeholder="you@example.com" required class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100" />
</label>
<button type="submit" class="w-full rounded-md bg-gray-900 px-4 py-2 text-sm font-medium text-white shadow-sm transition-colors hover:bg-gray-800 disabled:opacity-60 dark:bg-white dark:text-gray-900 dark:hover:bg-gray-200">Subscribe</button>
</form>Add your access key
Replace the placeholder with your access key to start receiving submissions.
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">Docusaurus newsletter form FAQ
Paste a form. Get submissions.
Instantly without setting up any backend, servers or databases. 250 submissions/mo free - no credit card.