Docusaurus feedback form
Add a was-this-helpful form to your Docusaurus docs with no plugin. Paste it into the MDX page, rename class to className, and reader feedback lands 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 the .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
A rating plus a comment is the sweet spot
One select for the score and one textarea for the why gives you both a number to track and the context behind it, without a long form.
Let people stay anonymous
Mark name and email optional. Feedback is more honest when it is not tied to an identity, and you still filter spam automatically.
Route feedback where you will see it
Forward submissions to a shared inbox or a webhook into your tracker so nothing sits unread.
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">Name (optional)
<input type="text" name="name" 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 (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">Rating
<select name="rating" 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>5 - Excellent</option>
<option>4 - Good</option>
<option>3 - Okay</option>
<option>2 - Poor</option>
<option>1 - Bad</option>
</select>
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Your feedback
<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 feedback</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 feedback form FAQ
Paste a form. Get submissions.
Instantly without setting up any backend, servers or databases. 250 submissions/mo free - no credit card.