IsharaBeta
Install guides (31)

Add Ishara to Docusaurus

Add the feedback widget to a Docusaurus site with one entry in the scripts array of docusaurus.config.js, which loads it on every page.

Where it goes
scripts in docusaurus.config.js
Allowed domains
Your own domain (set when you add the site)
Time
About 2 minutes

Steps

  1. In Ishara, open Sites → your site → Install and copy the line under Add the line to your site. Your site’s key is already in it:

    HTML
    <script src="https://useishara.com/w.js" data-site="pk_…" defer></script>
  2. In docusaurus.config.js, add the script to the top-level scripts array as an object, so it can carry data-site. Docusaurus accepts any attribute there and adds the tag to the <head> of every page:

    docusaurus.config.js
    export default {
      // …your existing config
      scripts: [
        {
          src: "https://useishara.com/w.js",
          defer: true,
          "data-site": "pk_…",
        },
      ],
    };
  3. Build and deploy the site.

  4. Open your site. Back on the Install page, Check it’s live turns into The widget is live as soon as the widget loads. Then open the Reviewer link from the same page: only people who open it see Leave a note.

Good to know

  • Keep defer: true: Docusaurus notes that scripts added here block rendering otherwise.

Next

Once reviewers leave notes, your coding agent can apply them. The widget’s options (language, position, colour, launcher) are in the docs.