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

# Shopify

## Add Humblytics Analytics to Shopify

{% hint style="info" %}
A dedicated Shopify app is coming soon and will make this a one-click install. Until then, installation is a one-line manual snippet in your theme code. It takes about 2 minutes.
{% endhint %}

### 1 · Sign up (or log in)

Visit humblytics.com → Start Free Trial. Finish signup, or log in to your existing workspace.

### 2 · Add your website in Humblytics

In the sidebar, click **Add Website**.

* **Domain**: enter `your-store.com` (omit `https://` and `www`). If your store lives on `your-store.myshopify.com`, use that domain instead.
* **Site Name**: internal label (e.g. `Store-Prod`)

Copy the snippet from **Install Tracking Code**:

```html
<!-- Start Humblytics Tracking Code -->
<script async src="https://app.humblytics.com/hmbl.min.js?id=YOUR_ID_HERE"></script>
<!-- End Humblytics Tracking Code -->
```

Keep this tab open. We'll return and click **Verify Website** once the tag is live.

### 3 · Add the script to your Shopify theme

1. In your Shopify admin, go to **Online Store → Themes**
2. On your live theme, click the **three-dot menu (⋯) → Edit code**
3. In the file list, open **Layout → theme.liquid**
4. Find the closing `</head>` tag (usually near the top of the file)
5. Paste your Humblytics snippet on the line just before `</head>`
6. Click **Save**

**Note**: Replace `YOUR_ID_HERE` with your actual project ID from Humblytics.

{% hint style="warning" %}
The script lives in your published theme. If you switch or replace your theme later, you'll need to re-add the snippet to the new theme's `theme.liquid`.
{% endhint %}

### 4 · Verify installation

1. Return to Humblytics and click **Verify Website**
2. Open your live storefront in a private/incognito window and refresh once
3. Within \~30 seconds you should see a green **Verified** badge and live visitor count

**If verification fails, check:**

* Script ID matches your project in Humblytics
* The domain you added in Humblytics matches the domain visitors actually land on (with or without `www`)
* The script appears in your page source (right-click → View Page Source, search for "humblytics")
* Open DevTools → **Network** tab, refresh, and filter for `hmbl.min.js`. A 200 status means the script is loading.
* Your dashboard says **Waiting for visitors**? That means the script is verified but no pageviews have arrived yet. Visit the site in an incognito window, or see [Verify & Troubleshoot Tracking](/how-to-get-started/verify-and-troubleshoot-tracking.md).

### 5 · Revenue tracking on Shopify

{% hint style="warning" %}
**Shop Pay and Shopify Payments checkout revenue is not tracked.** Humblytics revenue attribution natively supports **Stripe** and **Foxy**. Shopify's checkout runs on Shopify's own sandboxed domain, so purchase events there can't be captured by the tracking script.
{% endhint %}

What you can do today:

* **Storefront analytics, funnels, heatmaps, and A/B tests** all work normally on your store pages.
* If your store charges through **Stripe**, connect the [Stripe integration](/how-to-track-purchase-events/stripe.md) for full revenue attribution.
* For other setups, see [Other Payment Providers](/how-to-track-purchase-events/other-providers.md) for what's possible with custom purchase events, and the limitations that apply to hosted checkouts.

If Shop Pay revenue tracking matters to your business, email <support@humblytics.com>. We're gauging demand for deeper Shopify integrations.

### FAQ

**Does this work on Shopify Plus?**\
Yes. The same snippet works across all Shopify tiers, including Plus.

**Will it slow down my store?**\
No. The script is \~36 KB, loads asynchronously, and doesn't block page rendering.

**Are checkout pages tracked?**\
No. Shopify's checkout runs on a separate, sandboxed domain that doesn't load theme code. Storefront pages (home, collections, products, cart) are all tracked.