# Add Ishara to Mintlify

Add the feedback widget to your Mintlify docs with a small JavaScript file next to docs.json, which Mintlify loads on every page.

- Where it goes: A `.js` file next to `docs.json`
- Allowed domains: your own domain, plus your-project.mintlify.site
- Time: about 3 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 your docs repository, create `ishara.js` in the same folder as `docs.json`, with this code. It adds the same line from JavaScript, and Mintlify loads every `.js` file in that folder on every page, so you don’t need to reference it anywhere:

```
(function () {
  var s = document.createElement("script");
  s.src = "https://useishara.com/w.js";
  s.defer = true;
  s.dataset.site = "pk_…";
  document.head.appendChild(s);
})();
```

3. Commit and push to deploy, or click **Publish** in the web editor.
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

- Don’t paste the line into an MDX page: Mintlify asks you to load third-party scripts from a `.js` file instead.
- Mintlify’s consent integrations (OneTrust, Transcend) only cover scripts loaded through `integrations` in `docs.json`, not your own `.js` files.
- Preview deployments run custom scripts too. If the widget doesn’t appear on one, open your browser’s console: the widget names the address it was blocked on; add that host to the site’s allowed domains.

Checked against the official docs on 2026-11-12: [Mintlify: custom scripts](https://www.mintlify.com/docs/customize/custom-scripts), [Mintlify: integrations](https://www.mintlify.com/docs/organize/settings-integrations), [Mintlify: deployments](https://www.mintlify.com/docs/deploy/deployments), [Mintlify: preview deployments](https://www.mintlify.com/docs/deploy/preview-deployments), [Mintlify pricing](https://www.mintlify.com/pricing).
