Add Antlytics to Gatsby

Prerequisites

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

Install the snippet

Use Gatsby's onRenderBody SSR hook to inject the hosted tracker into the <head> of every page.

Create or edit gatsby-ssr.tsx in your project root:

// gatsby-ssr.tsx
import React from "react";
import type { GatsbySSR } from "gatsby";

export const onRenderBody: GatsbySSR["onRenderBody"] = ({
  setHeadComponents,
}) => {
  setHeadComponents([
    <script
      key="antlytics"
      defer
      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.

Gatsby also calls onRenderBody during static generation, so every pre-built page includes the snippet.

Verify installation

Visit your site in a browser.
Open your Antlytics dashboard → Overview.
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.