> 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/framer.md).

# Framer

Add Humblytics to your Framer site in about 2 minutes.

{% hint style="info" %}
**You need:** access to your Framer project's **Site Settings**. Custom code runs on the published site only, not in the editor preview.
{% endhint %}

## 1. Copy your tracking code

In Humblytics, open **Site settings → Install** and click **Copy tracking code**. Adding a new site? The code appears in step 2 of **Add Site**.

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

## 2. Paste it into Framer

1. Open your project and go to **Site Settings → Custom Code**.
2. Click **Add Script** (or **+**) and name it `Humblytics`.
3. Paste the snippet.
4. Set placement to **Start of `<head>` tag**, apply it to **All pages**, and save.

<figure><img src="https://1281224403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqZMBn2D7F1lV2hgGTS2X%2Fuploads%2FvRZC4hFFcakjq9DCwphv%2Fframer%20script.gif?alt=media&amp;token=4a88c337-eb64-43a7-be6a-1868e25e46ac" alt=""><figcaption></figcaption></figure>

To track only certain pages, add the script in that page's settings under **Custom Code** instead.

## 3. Publish and verify

1. Click **Publish**. Saving alone doesn't put the code live.
2. Back in Humblytics, click **Verify install**.
3. Open your published site in a private window and click around. Your visit appears in **Observe → Analytics → Overview** under **Live Activity** within about a minute.

**Not verifying?**

* Test the published URL (`yourdomain.com` or `yourproject.framer.website`), not the editor.
* The domain in Humblytics must match the one you published to.
* The script must be in **Start of `<head>`**, not the end of `<body>`.

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