How to add analytics to Mintlify docs

Mintlify's built-in analytics integrations are configured in docs.json, but VisitTrack isn't one of them — so you use Mintlify's custom scripts feature. Mintlify recommends injecting third-party scripts from JavaScript rather than writing raw <script src> tags in MDX, which is what the file below does.

Use the same data-site as your marketing site when the docs live on a subdomain like docs.example.com: subdomains of one root domain share the visitor id, so a reader who goes from docs to signup is one visitor with one source.

How to install VisitTrack on Mintlify

1. 1

   Step 1: Copy your site id

   Use the site id of your main product site (recommended for docs.yourdomain.com), or create a separate site for the docs. Replace SITE_ID below.

2. 2

   Step 2: Create visitrack.js in your docs repo

   Place it in the content directory (next to docs.json). It creates the same tag as the standard snippet, and skips if the tag already exists so it can never load twice.

   visitrack.jsCopy

   (function () {
     if (document.querySelector('script[src="https://visitrack.app/tracker.js"]')) return;
     var s = document.createElement("script");
     s.defer = true;
     s.src = "https://visitrack.app/tracker.js";
     s.setAttribute("data-site", "SITE_ID");
     document.head.appendChild(s);
   })();

3. 3

   Step 3: Allow the docs hostname

   If you've saved Allowed hostnames in VisitTrack's Settings → General, add docs.yourdomain.com (or *.yourdomain.com). Until you save a list, every hostname counts.

4. 4

   Step 4: Commit and deploy

   Push the file. Mintlify deploys on push to your docs branch; the script runs once the deployment is live. Local previews on localhost are ignored by the tracker.

How to check VisitTrack is working on Mintlify

1. Open your live docs and click through two or three pages in the sidebar.
2. VisitTrack's live view shows you; the Pages tab lists each docs path. With a shared site id, filter by host in the Hostname tab to see docs only.
3. DevTools → Network: one POST to visitrack.app/api/collect per page change.

Does VisitTrack track Mintlify page navigation?

Mintlify docs switch pages in the browser without a full reload. The tracker follows History API navigations, so each docs page a reader opens is one pageview. Jumping to a heading anchor (#authentication) doesn't change the path and isn't counted again.

Mintlify custom scripts run after the page becomes interactive, so a reader who closes the tab within the first moment may not be counted — a small, consistent undercount rather than a skew.

How to track custom events and goals in Mintlify

Links from your docs to your app ("Get an API key", "Sign up") on another subdomain are outbound clicks, tracked automatically. To name a specific call to action, MDX accepts plain JSX attributes, so data-vt-goal works on links you write:

<a href="https://app.example.com/signup" data-vt-goal="docs_signup_click">
  Create a free account
</a>

With a shared site id, the signup event your app already sends lands on the same visitor — so you can build a funnel from a docs page to signup and see which guides convert. See custom events.

Script options you might need on Mintlify

All optional — add them to the same tag. Full reference: script configuration.

Mintlify troubleshooting

Not on Mintlify? See all 29 integration guides.