New: Free plan is live 7 August 2026 · View changelog →
Antlytics logoAntlytics

Add Antlytics to Starlight

Prerequisites

  • An Antlytics account (sign up free)
  • Your tracking ID from Settings → Tracking Snippet in your Antlytics dashboard

Install the snippet

Starlight is built on Astro. Add the hosted tracker via the head option in your Starlight integration config in astro.config.mjs:

// astro.config.mjs
import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";

export default defineConfig({
  integrations: [
    starlight({
      title: "My Docs",
      // ... your existing Starlight config ...

      head: [
        {
          tag: "script",
          attrs: {
            defer: true,
            src: "https://www.antlytics.com/tracker.js",
            "data-tracking-id": "YOUR-SITE-ID",
            "data-api-host": "https://www.antlytics.com",
          },
        },
      ],
    }),
  ],
});

Note: Replace YOUR-SITE-ID with the tracking ID from your Antlytics dashboard.

This injects the script into every Starlight page, including the sidebar layout.

Verify installation

  1. Visit your site in a browser.
  2. Open your Antlytics dashboard → Overview.
  3. Your visit should appear within a few seconds.

If data does not appear after a few minutes, check the troubleshooting guide.

Optional: First-party proxy

To avoid ad blockers, set up a first-party proxy on your own domain.

Need help?

Email support@antlytics.com with your site ID and page URL.

Something missing? Get in touch and we will update these docs.