> For the complete documentation index, see [llms.txt](https://docs.humblytics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humblytics.com/how-to-get-started/beehiiv.md).

# beehiiv

Add Humblytics to your beehiiv website in about 2 minutes.

{% hint style="info" %}
**You need:** a beehiiv plan that lets you add custom code to your website. If your plan only offers **Tracking pixels**, use the Google Tag Manager route below.
{% endhint %}

## 1. Copy your tracking code

In Humblytics, open **Site settings → Install** and click **Copy tracking code**. Adding a new site? Click **Add site** on **Home**, pick **Beehiiv**, and the code appears in the install step.

Copy the whole snippet, from `<!-- Start Humblytics Tracking Code -->` to `<!-- End Humblytics Tracking Code -->`.

## 2. Paste it into beehiiv

1. In beehiiv, go to **Website → Settings** (or **Design → Custom code**).
2. Paste the snippet into the **Header** / head custom-code field for your website.
3. Save. If your website has been published before, the change goes live on its own; otherwise publish once.

**No custom-code field on your plan?** Load Humblytics through Google Tag Manager instead:

1. Add the Humblytics tag to a GTM container and publish it. Follow [Google Tag Manager](https://docs.humblytics.com/how-to-get-started/google-tag-manager.md) up to the **Publish** step.
2. In beehiiv, go to **Website → Builder**, click the **Settings** icon, then **Site settings → Tracking pixels**.
3. Paste your GTM container ID (`GTM-XXXXXXX`) into the **Google Tag Manager** field. beehiiv saves it automatically.

## 3. Verify

1. Back in Humblytics, click **Verify install** (during first-time setup, **Check my site now**). Through GTM it can take a few minutes after publishing.
2. Open your public beehiiv website in a private window (not the beehiiv dashboard) and click around. Your visit appears in **Observe → Analytics → Overview** under **Live Activity** within about a minute.

**Not verifying?**

* The domain in Humblytics matches your beehiiv website domain (custom domain or `yourname.beehiiv.com`).
* If you used GTM, the container is **published**, not just saved.

Still stuck? See [Verify & Troubleshoot Tracking](https://docs.humblytics.com/how-to-get-started/verify-and-troubleshoot-tracking.md).

## Next: track paid subscriptions

To see which traffic turns into paid subscribers, set up [beehiiv revenue tracking](https://docs.humblytics.com/how-to-track-purchase-events/beehiiv-revenue-tracking-and-split-testing.md).
