Add an AI support agent to your Mintlify docs.

A chat on every page of your Mintlify docs that answers from your docs, shows the passage it used, and hands what it can’t answer to you.

Add to your code · 7 steps

Before you start.

  • On hiy

    A Support Agent. Making your first one starts a 14-day free trial, no card needed, one per account.

    Make one from your site

  • Who can ask it

    Anyone, even a script, can ask an open agent, so treat what it knows as public.

    Open on your site

  • Visitors who sign in

    Leave it closed and have your own server sign each visitor a token instead.

    Recipes for signed-in visitors

Step by step.

Three steps in hiy, 3 on Mintlify, then a test.

In hiy

  1. Add your site in hiy

    In your Support Agent, on the Install card, type your site’s address and press Save.

  2. Switch on Open on your site

    It asks you once before it opens. Anyone on your sites, even a script, can then ask it, so treat what it knows as public.

  3. Copy the line

    Copy the one line it shows. data-twin names your agent.

    <script src="https://hiy.ai/embed.js" data-twin="your-agent" data-mode="bubble" async></script>

On Mintlify

  1. Add a .js file

    Create a file such as hiy.js in your content directory, the folder that holds docs.json. Mintlify runs every .js file there on every page.

  2. Load the embed from it

    In that file, create the script element, as Mintlify advises for third-party scripts, rather than a <script> tag in MDX.

    hiy.js

    const script = document.createElement('script');
script.src = 'https://hiy.ai/embed.js';
script.async = true;
script.dataset.twin = 'your-agent';
script.dataset.mode = 'bubble';
document.head.appendChild(script);

  3. Deploy

    Commit and deploy your docs.

Then

  1. Test it on your live site

    Open a page of your published site and ask something your docs answer, then something they don’t. hiy opens only on https pages of the sites on your list.

Checked 16 October 2026 against Mintlify’s own help:

Worth watching for.

  • Mintlify runs custom JavaScript once per visit and swaps pages without reloading, so the embed loads once.
  • If your site sends a Content-Security-Policy, allow script-src https://hiy.ai and frame-src https://hiy.ai.
  • On an address like yours.mintlify.app, list that exact host in hiy. hiy refuses mintlify.app on its own, because many sites share it.

Train it on your Mintlify docs.

In hiy, go to Agents, press New Support Agent, paste your site’s address and press Find its pages. It lists the pages and reads none of them until you create the agent, and Choose pages unticks pages or adds links.

hiy reads a site’s sitemap to find its pages. Mintlify generates /sitemap.xml with the pages in your docs.json navigation.

When the site changes, open it in Knowledge and press Re-sync now, or have it re-read weekly or monthly. New pages are offered, never added.

How setup worksSyncing a website

Questions people ask first.

Do I need a developer to add hiy to Mintlify?

Whoever edits a .js file in your docs folder and deploys the site can do it. hiy needs no server of yours.

Is my agent’s knowledge public on my Mintlify docs?

With Open on your site switched on, yes. Anyone on the sites you list can ask it, and so can a script, so treat what it knows and its instructions as public.

What if my visitors sign in?

Leave Open on your site off and have your own server sign each visitor a short-lived token instead. The chat API guide shows how.

Put it on your own site. Start free; the paid plan is free for 14 days.

Start free
  • 14-day free trial
  • No card needed
  • Paste a URL to start