Contact forms for Docusaurus

Add a contact form to your Docusaurus site with no plugin and no backend of your own. Docs pages are MDX, so the form is markup you paste straight into the page - just remember MDX wants className instead of class. Preview it live, copy the code, and submissions land in your inbox - spam filtered.

How to create a Docusaurus form

1
Create a form in your Formpaste dashboard and copy its access key.
2
Paste the markup into an .mdx page and rename class to className.
3
Replace YOUR_ACCESS_KEY_HERE with your access key, then deploy.

Prompt for your AI coding agent

Add a Formpaste contact form to my Docusaurus site. Give me JSX-safe markup for an .mdx page that POSTs to https://api.formpaste.com/submit with method POST and a hidden access_key input, using className instead of class and object syntax for any inline style. No plugin, no swizzling, no backend.

Or connect the Formpaste MCP server to Claude Code, Codex, Cursor, Claude Desktop, VS Code, or any mcp-remote client. See the setup guide.

A form in your MDX

Docusaurus docs, blog posts, and standalone pages are all MDX, so a contact form is markup you paste into the page. There is no plugin to install, no theme component to swizzle, and no backend of your own - the browser posts straight to Formpaste and the submission lands in your inbox.

className, not class

This is the one thing that trips people up. In MDX anything that looks like HTML is actually JSX, so class="..." is not valid - rename it to className="...". Inline styles follow JSX too, so style="margin-top: 1rem" becomes style={{marginTop: '1rem'}}. The unstyled CSS snippet is the easiest starting point because there is less to rename.

Where to put it

A one-off form is fine directly in the page body. When the same form belongs on many pages, move it into src/components/ as a .jsx or .tsx file and import it into each doc - that is the pattern the Docusaurus docs recommend for anything non-trivial, and it keeps the markup out of your prose.

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.

1

Create your form

Sign up, verify your email, and create an access key in your dashboard.

2

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">Name
    <input type="text" name="name" placeholder="Your name" 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>
  <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>
  <label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Message
    <textarea name="message" required class="min-h-28 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"></textarea>
  </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">Send</button>
</form>

3

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">

Contact forms for Docusaurus FAQ

Paste a form. Get submissions.

Instantly without setting up any backend, servers or databases. 250 submissions/mo free - no credit card.

Start free Read the docs

What you get with Formpaste

No server, no DNS

Point your form at Formpaste - no backend, no DNS, no email server to run.

Spam filtered automatically

Heuristics + a quarantine folder you control. Real messages always get through.

Quarantine you control

Suspicious submissions land in a folder you review - nothing silently dropped.

Built for AI agents

An MCP server your coding agent calls to create a form and wire it up.

Copy-paste components

Accessible, copy-paste form code for HTML, React, TypeScript, JavaScript, and Astro.

Simple dashboard

Manage forms, inbox, quarantine, and delivery from one place.

More Docusaurus forms

Other platforms