GitBook

GitBook feedback form without a backend

GitBook does not run custom HTML: its content security policy blocks external HTML and iframe tags, and the Embed block only shows URLs from providers that GitBook's embed service supports. A form you paste into a page will not work. What does work is a link. Publish the form as a Formward hosted form, add a button or link to it from your docs, and each response is stored in Sweden and emailed to you.

1. 01Create a hosted feedback form in Formward

   Sign up at formward.eu and create a form from a hosted template. General feedback (a rating, a comment and an optional email) and Website feedback both suit documentation. Formward gives the form a public link at formward.eu/s/your-slug. Free includes one active hosted form.

   To change the questions, open the form in Pages and edit them in the Form tab. The new questions appear on the hosted link once you publish the form.

2. 02Copy the link

   Open the form's Settings, go to the Hosted pages tab and copy the hosted form link. Open it once in a private window to check that the form shows up.

   https://formward.eu/s/your-slug

3. 03Add a button or link in GitBook

   In the GitBook editor, type / and choose Button, then set the label (for example "Send feedback") and paste the link as its URL. For a lighter touch, select some text and press Cmd+K or Ctrl+K to turn it into a link instead. The end of each page works well, or a hint block on the pages that get the most questions.

   External links open in the same tab in GitBook, so the reader leaves the docs to answer. Keep the form short so they come back quickly.

4. 04Test and view responses

   Publish the GitBook space, click the button and send a test response. It appears in the Formward dashboard and in the notification email. The hosted page carries the honeypot and rate limit by default, and you can switch on Cloudflare Turnstile for the form if spam gets through.