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

# Getting Started

Add your site, install one script, connect revenue, and choose the events you care about. Page views, traffic sources, and clicks are tracked automatically from the moment the script goes live.

## Set up in four steps

{% stepper %}
{% step %}

### Add your website

In Humblytics, add the live domain you want to track, such as `yourdomain.com`. Humblytics adds it to your workspace and generates its tracking script.

<figure><img src="https://1281224403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqZMBn2D7F1lV2hgGTS2X%2Fuploads%2FKNzQc3GeAiysakndXZYB%2Fadding%20domain.gif?alt=media&amp;token=69a86a27-cee4-4409-b9b8-2cae699c7ec6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Install the tracking script

In **Site settings → Install**, click **Copy tracking code** and paste it into the global `<head>` of your site so it loads on every page. Then publish your site.

One script powers analytics, heatmaps, funnels, and experiments. You never add a second one.

<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>

#### **Pick your platform for step-by-step instructions:**

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Astro</strong></td><td><a href="/how-to-get-started/astro.md">Astro</a></td></tr><tr><td><strong>beehiiv</strong></td><td><a href="/how-to-get-started/beehiiv.md">beehiiv</a></td></tr><tr><td><strong>Bolt</strong></td><td><a href="/how-to-get-started/bolt.md">Bolt</a></td></tr><tr><td><strong>Bubble</strong></td><td><a href="/how-to-get-started/bubble.md">Bubble</a></td></tr><tr><td><strong>Django</strong></td><td><a href="/how-to-get-started/django.md">Django</a></td></tr><tr><td><strong>Framer</strong></td><td><a href="/how-to-get-started/framer.md">Framer</a></td></tr><tr><td><strong>Ghost</strong></td><td><a href="/how-to-get-started/ghost-cms.md">Ghost CMS</a></td></tr><tr><td><strong>GoHighLevel</strong></td><td><a href="/how-to-get-started/gohighlevel.md">GoHighLevel</a></td></tr><tr><td><strong>Google Tag Manager</strong></td><td><a href="/how-to-get-started/google-tag-manager.md">Google Tag Manager</a></td></tr><tr><td><strong>Kajabi</strong></td><td><a href="/how-to-get-started/kajabi.md">Kajabi</a></td></tr><tr><td><strong>Kit</strong></td><td><a href="/how-to-get-started/kit.md">Kit</a></td></tr><tr><td><strong>Laravel</strong></td><td><a href="/how-to-get-started/laravel.md">Laravel</a></td></tr><tr><td><strong>Lovable</strong></td><td><a href="/how-to-get-started/lovable.md">Lovable</a></td></tr><tr><td><strong>Next.js</strong></td><td><a href="/how-to-get-started/nextjs.md">Next.js</a></td></tr><tr><td><strong>Podia</strong></td><td><a href="/how-to-get-started/podia.md">Podia</a></td></tr><tr><td><strong>React Router</strong></td><td><a href="/how-to-get-started/react-router.md">React Router</a></td></tr><tr><td><strong>Replit</strong></td><td><a href="/how-to-get-started/replit.md">Replit</a></td></tr><tr><td><strong>Shopify</strong></td><td><a href="/how-to-get-started/shopify.md">Shopify</a></td></tr><tr><td><strong>Squarespace</strong></td><td><a href="/how-to-get-started/squarespace.md">Squarespace</a></td></tr><tr><td><strong>Vercel v0</strong></td><td><a href="/how-to-get-started/vercel-v0.md">Vercel v0</a></td></tr><tr><td><strong>Vue.js</strong></td><td><a href="/how-to-get-started/vuejs.md">Vue.js</a></td></tr><tr><td><strong>Webflow</strong></td><td><a href="/how-to-get-started/webflow.md">Webflow</a></td></tr><tr><td><strong>Wix</strong></td><td><a href="/how-to-get-started/wix.md">Wix</a></td></tr><tr><td><strong>WordPress</strong></td><td><a href="/how-to-get-started/wordpress.md">WordPress</a></td></tr></tbody></table>

Not listed? Any site where you can edit the `<head>` works. If you can’t edit code, use [Google Tag Manager](/how-to-get-started/google-tag-manager.md).

{% hint style="info" %}
**What's in the snippet?** Two short scripts. The first hides the page for a moment (2 seconds at most) so A/B-test visitors never see the original flash before their variant. The second loads Humblytics. Paste both, exactly as copied.
{% endhint %}

**Verify your installation**

1. Open your live site in a private or incognito window, with ad blockers turned off.
2. Visit a page or two and click a link or button.
3. In Humblytics, go to **Observe → Analytics → Overview**.
4. Look for your visit and click in **Live Activity**.

<figure><img src="https://1281224403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqZMBn2D7F1lV2hgGTS2X%2Fuploads%2F98oEqno9HBLlyrhcW2We%2Flive%20activity.gif?alt=media&amp;token=977de47c-1de9-4a71-a045-89bb159899b6" alt=""><figcaption></figcaption></figure>

Your visit should appear within about 60 seconds. If it doesn’t, confirm the script is in the global `<head>`, the site is published, and the domain matches the one you added in step 1.

[Troubleshoot tracking→](/how-to-get-started/verify-and-troubleshoot-tracking.md)
{% endstep %}

{% step %}

### Connect revenue to your traffic

Connect Stripe, Foxy, or another supported payment provider. Humblytics matches each purchase to the channel, campaign, landing page, and experiment variant that brought the buyer in.

<figure><img src="https://1281224403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqZMBn2D7F1lV2hgGTS2X%2Fuploads%2Fxz7nXTO4iJzkhBSNyAsv%2Fstripe%20connection.gif?alt=media&amp;token=3e5ad84a-ae8a-4173-a003-39acfca97ad4" alt=""><figcaption></figcaption></figure>

New purchases then show up in **Analytics** and **Attribution**, so you see which traffic makes money, not only which traffic arrives.

[Set up revenue attribution →](https://docs.humblytics.com/how-to-track-purchase-events)

**No online payments?** Skip to step 4 and track leads, bookings, or signups instead.
{% endstep %}

{% step %}

### Set up the events that matter

Page views and standard clicks are already tracked. Add setup only for the actions that count as success on your site.

| If success means…                             | Set up                                                                                       |
| --------------------------------------------- | -------------------------------------------------------------------------------------------- |
| A lead, demo request, booking, or signup form | [Form submission tracking](https://docs.humblytics.com/how-to-track-custom-form-submissions) |
| A click on a specific CTA or button           | [Custom click events](https://docs.humblytics.com/how-to-track-custom-click-events)          |

**Not sure yet?** Skip this step and look around your dashboard first. You can add events later, once you know what you want to measure in funnels and tests.

You’re **set up** when your own visit shows in Live Activity and the conversions that matter most to you are tracked.

<figure><img src="https://1281224403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqZMBn2D7F1lV2hgGTS2X%2Fuploads%2FkxWScfnUsix8TLppx02L%2Fanalytics%20subtabs.gif?alt=media&amp;token=b44d3142-5dab-4fed-81e9-fc2f36ce5658" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### Next steps: find what to improve

Once data is coming in, work through these in order. Each one builds on the last.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><strong>1 · See what's happening</strong></h4></td><td><strong>Read your first report</strong></td><td>In <strong>Observe → Analytics</strong>, start with Overview, Pages, Channels, Clicks, and Forms to learn where visitors come from and what they do.</td><td><a href="/understanding-your-data.md">Understand your data →</a></td><td><a href="/understanding-your-data.md">Understanding Your Data</a></td></tr><tr><td><h4><strong>2 · See how pages are used</strong></h4></td><td><strong>Open a heatmap</strong></td><td>See where visitors click and how far they scroll. Compare desktop and mobile to spot content people miss.</td><td><a href="/understanding-your-data/understanding-heatmap.md">Explore heatmaps →</a></td><td><a href="/understanding-your-data/understanding-heatmap.md">Understanding Heatmap</a></td></tr><tr><td><h4><strong>3 · Find the leak</strong></h4></td><td><strong>Build a funnel</strong></td><td>Map the path from a page visit to a click, form, or purchase, and find the step where you lose the most visitors.</td><td><a href="/understanding-your-data/understanding-funnels.md">Build your first funnel →</a></td><td><a href="/understanding-your-data/understanding-funnels.md">Understanding Funnels</a></td></tr><tr><td><h4><strong>4 · Fix it</strong></h4></td><td><strong>Run an A/B test</strong></td><td>Test a new version of that page against the original, with your conversion as the goal.</td><td><a href="/split-testing-overview.md">Set up your first test →</a></td><td><a href="/split-testing-overview.md">Split Testing Overview</a></td></tr></tbody></table>

***
