Docusaurus survey form
Add a short survey to your Docusaurus docs with no plugin. Use dropdowns for quick answers and one open field, paste it into an MDX page, and responses land in your inbox. 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 an .mdx 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
Keep it short to keep completion high
Every extra question loses responses. A couple of dropdowns and one open comment field usually gathers what you need without fatigue.
Dropdowns beat free text for analysis
Fixed choices (select fields) are easy to count later. Reserve the textarea for the one open-ended question that genuinely needs it.
Make email optional for honest answers
Anonymous responses are often more candid. Ask for email only if you need to follow up, and mark it optional.
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 (optional)
<input type="email" name="email" placeholder="you@example.com" 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">What best describes you?
<select name="role" 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">
<option>Developer</option>
<option>Designer</option>
<option>Founder</option>
<option>Other</option>
</select>
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">How satisfied are you?
<select name="satisfaction" 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">
<option>Very satisfied</option>
<option>Satisfied</option>
<option>Neutral</option>
<option>Unsatisfied</option>
</select>
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Anything else?
<textarea name="comments" 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">Submit survey</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 survey form FAQ
Paste a form. Get submissions.
Instantly without setting up any backend, servers or databases. 250 submissions/mo free - no credit card.