> For the complete documentation index, see [llms.txt](https://help.littledata.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.littledata.io/sources/shopify/littledata-pixel.md).

# Littledata Pixel

Add the Littledata Pixel as a Shopify custom pixel to improve tracking on headless storefronts and send redundant events to Meta, TikTok and Pinterest.

The Littledata Pixel is a custom web pixel you add from your Shopify admin. It works alongside Littledata's server-side tracking to fill gaps and make tracking more reliable, on your Shopify store and on headless storefronts. This page shows you how to add it, which events it sends, and how to check it's working.

{% hint style="info" %}
The Littledata Pixel is not your Meta pixel. You only need one per store, whichever Meta pixels or ad accounts you use. To send data to a different Meta pixel, [change the Pixel ID in your Meta destination](https://help.littledata.io/integrations/facebook-capi/meta-capi-faq#how-do-i-switch-littledata-to-a-new-meta-pixel-or-ad-account).
{% endhint %}

### Key benefits

* **Shopify Hydrogen and headless support:** consistent tracking across a headless storefront.
* **Redundant tracking:** both client-side and server-side events for key destinations.
* **Custom landing page support:** track customers across non-Shopify pages.
* **Accelerated checkout support:** track conversions across Shop Pay and other accelerated checkouts.

### How to add the Littledata Pixel

{% stepper %}
{% step %}
**Start the setup in the Littledata app**

In the Littledata app, find the **Littledata Pixel** under **Sources**. Click **Continue** to start the setup.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-c1ad339f0a6b39c832c87be2564dc2d231f7b698%2Flittledata_pixel_pending_setup.png?alt=media" alt="Littledata Pixel with Pending setup status and a Continue button in the Littledata app"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Open Customer events in Shopify**

In your Shopify admin, go to **Settings** > **Customer events**.
{% endstep %}

{% step %}
**Add a custom pixel**

Click **Add custom pixel**. Name it exactly `Littledata - Advanced Tracking`, then click **Add pixel**.

The name must match so Littledata can detect the pixel on your store.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-c8386bdeee25bf38490301c8e559261cc5ea9741%2Fname.png?alt=media" alt="Add custom pixel dialog in Shopify with the pixel name Littledata - Advanced Tracking"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Set the customer privacy settings**

Under **Permission**, select **Not required**. Under **Data sale**, select **Data collected does not qualify as sale**. This lets the Littledata Pixel load. Littledata handles consent through Shopify's Customer Privacy API.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-e9d5d092ee417371b77b33b357c78b17e9352c30%2Fprivacy_settings.png?alt=media" alt="Customer privacy settings with Not required and Data collected does not qualify as sale selected"><figcaption></figcaption></figure></div>

{% hint style="info" %}
On a headless setup, if your cookie banner isn't automatically connected to the Customer Privacy API, check your cookie banner's documentation to connect it manually. If you use a custom storefront instead of Hydrogen, you also need to [include the Customer Privacy API asset](https://shopify.dev/docs/api/customer-privacy#installation-on-a-custom-storefront).
{% endhint %}
{% endstep %}

{% step %}
**Paste the pixel code**

Go back to the Littledata app and copy the custom pixel code. Paste it into the **Code** box of your new pixel in Shopify.
{% endstep %}

{% step %}
**Save and connect**

Click **Save**, then click **Connect**.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-91964e09f85db9a59953f3be8fc94ba4c630ab8c%2Fscreenshot-2025-04-02-162249.png?alt=media" alt="Shopify custom pixel page with Save and Connect buttons"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

When setup is complete, you go back to the Littledata app. The **Littledata Pixel** shows **Connected** once the pixel is detected on your store.

### Redundant tracking

Added on top of Littledata's server-side tracking, the Littledata Pixel gives you fully redundant tracking in destinations that accept both client-side and server-side events:

* [Meta](https://help.littledata.io/integrations/facebook-capi/how-it-works-shopify-to-meta-conversions-api)
* [TikTok](https://help.littledata.io/integrations/tiktok/how-it-works)
* [Pinterest](https://help.littledata.io/integrations/shopify-to-pinterest/how-it-works)

This follows Meta's best practice for a [redundant setup](https://developers.facebook.com/docs/marketing-api/conversions-api/guides/end-to-end-implementation/).

{% hint style="info" %}
The Littledata Pixel does not send events to Google Analytics 4 or Google Ads. Those destinations get browsing events from Littledata's [app embed](https://help.littledata.io/advanced/developer/littledata-app-embed-how-it-works) and purchases from Littledata's servers.
{% endhint %}

#### Events the pixel collects

The pixel improves tracking of cart, checkout and purchase events for Meta Conversions API, TikTok and Pinterest.

| Destinations            | Web pixel event          | Meta event           | Description                                |
| ----------------------- | ------------------------ | -------------------- | ------------------------------------------ |
| Meta, TikTok, Pinterest | `product_added_to_cart`  | `AddToCart`          | An item is added to the cart               |
| Meta, TikTok            | `checkout_started`       | `InitiateCheckout`\* | A checkout starts                          |
| Meta, TikTok            | `payment_info_submitted` | `AddPaymentInfo`\*   | The customer submits payment info          |
| Meta, TikTok, Pinterest | `checkout_completed`     | `Purchase`\*         | The checkout is completed (thank you page) |

\*An extra `PageView` is sent with this event.

### Troubleshooting

#### Littledata Pixel status

Littledata checks regularly that both the tracking script (through the app embed) and the custom pixel are detected on your store. In the Littledata app, the **Littledata Pixel** shows one of these statuses:

| Status           | What it means                                | What to do                                    |
| ---------------- | -------------------------------------------- | --------------------------------------------- |
| **Connected**    | The pixel is detected on your store.         | Nothing.                                      |
| **Not detected** | Littledata's check could not find the pixel. | Click **Fix now** and follow the setup again. |

{% hint style="warning" %}
Make sure the pixel is named exactly `Littledata - Advanced Tracking`.
{% endhint %}

#### Check that the pixel loads

{% stepper %}
{% step %}
**Open the pixel test**

In your Shopify admin, go to **Settings** > **Customer events** and open the **Littledata - Advanced Tracking** pixel. Click **Test** to open your store with the pixel helper.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-690ac6abbfcee9945c22c7442d9f5941875ee5bb%2Fweb-pixel-test.png?alt=media" alt="Littledata - Advanced tracking pixel page in Shopify with the Test button highlighted"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Check the events**

Visit each page you want to test. In the **Pixel helper** dialog, check that the pixel shows as loaded and that the events you expect appear under **Events received**.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-10cedc611491d8b7a16899e7fa0745c26350a64a%2Fpixel-helper-events.png?alt=media" alt="Shopify Pixel helper showing Littledata - Advanced tracking loaded with product_added_to_cart events"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### Reconnect the pixel

If the pixel isn't firing, someone on your team may have disconnected it.

{% stepper %}
{% step %}
**Find the pixel**

In your Shopify admin, go to **Settings** > **Customer events** and find **Littledata - Advanced Tracking**.
{% endstep %}

{% step %}
**Connect it**

Click the three dots (**...**) on the right, then click **Connect**.

<div data-with-frame="true"><figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-63b5091fd38a14b655aadc008a47d1c987bf53c7%2Fscreenshot-2025-04-02-162821.png?alt=media" alt="Shopify Customer events list with the Connect option for a disconnected Littledata - Advanced tracking pixel"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Related articles

* [Headless or Shopify Hydrogen store installation](https://help.littledata.io/sources/shopify/headless-shopify/working-with-a-headless-shopify-setup)
* [Upgrading to the Littledata Pixel](https://help.littledata.io/sources/shopify/headless-shopify/upgrading-to-the-advanced-tracking-script)
* [How the Littledata app embed works](https://help.littledata.io/advanced/developer/littledata-app-embed-how-it-works)
* [How it works: Shopify to Meta Conversions API](https://help.littledata.io/integrations/facebook-capi/how-it-works-shopify-to-meta-conversions-api)