How to add a Send Feedback button for your Nextra website


This is a step by step guide to integrate Feelback with your Nextra website. This tutorial assumes you’re using the builtin Nextra theme: nextra-theme-docs. However, every Nextra website can be used.

With this guide you will add a Send Feedback button to your website sidebar.

Nextra sidebar with feedback button

When clicked it will open a dialog with a form like:

Nextra tagged message example

Guide goals

In this tutorial you will:

Step 1: Setup the Feelback project

If you don't have already a Feelback account, please signup and create one. It's free and doesn't require a credit card to use.

Access the Feelback panel, and create a project if you don't have any. Feelback panel projects

You can use your website name.

Feelback panel create project

After that, create a ContentSet which will contain your content and feedbacks you will receive.

Feelback panel create content-set

Pick the Tagged Message type to enable this content-set to receive Feedback signals.

Feelback panel content-set type

You will end up with a ContentSet like the following one:

Feelback panel content-set info

Step 2: Install the Feelback plugin

In your Nextra project directory, just install the @feelback/react package:

npm install @feelback/react

Step 3: Add the FeelbackTaggedMessage component to the sidebar

Now you are ready to add the Send Feedback buttons. Let’s suppose you want place the button on the right sidebar, just below the table of content.

To edit the docs theme nextra-theme-docs, in Nextra you should modify theme.config.tsx file. We can yse the toc extension point to display the feedback form:


import { DocsThemeConfig } from "nextra-theme-docs";

// import the components
import { FeelbackTaggedMessage, PRESET_FEEDBACK } from "@feelback/react";
// include the default style
import "@feelback/react/styles/feelback.css";

export default {
    logo: <span>My Nextra Documentation</span>,
    project: { link: "" },
    feedback: { content: null },
    toc: {
        extraContent: () =>
            <FeelbackTaggedMessage contentSetId="your-content-set-id"
} as DocsThemeConfig

The result should be something like this:

Nextra sidebar with feedback button

Additional documentation with all properties and customization you can use is available inside the dedicated React integration guide for each Feelback components.

Step 4: (Optional) Customize the component style

You can override the predefined style with additional CSS.

For example, you can add some selector to change the buttons background color.


.feelback-container .feelback-btn {
  background-color: "cyan";

Full documentation with advanced customization is available inside the React integration guide.


The @feelback/react package is open source and available on github. Any contribution is much appreciated. Issues, bug reports and feature requests are welcome. Do not hesitate to reach us or ask for help.

Additional resources

Other guides for Nextra