> For the complete documentation index, see [llms.txt](https://docs.ingestlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ingestlabs.com/troubleshooting/shopify-health-check-alerts.md).
# Shopify Health Check Alerts
Ingest Labs checks your Shopify storefront every hour to confirm that tracking is installed and working. If something breaks, we email the people on your organisation's Shopify alert list so it can be fixed before you lose more data.
This page explains each check and how to resolve it.
## Why this matters
When tracking breaks, **your store keeps running and looks completely normal**. Orders are unaffected and nothing appears wrong to shoppers. What stops is data collection — so visits, add-to-carts and checkouts go unrecorded, and marketing attribution degrades for as long as the problem lasts.
Because the damage is invisible from the storefront, these alerts are usually the first sign that anything is wrong. They repeat every hour until the problem is fixed, and you receive a confirmation email once everything is working again.
Most of these issues are caused by a routine change — a theme update, a new app, or an edit to your Customer events settings.
## Which fix do I need?
There are two fixes on this page. Match the alert you received to the right one:
| Alert | Fix |
| --------------------------- | ------------------------------------------------------------------------------------------------ |
| Theme App Embed Disabled | [Enable the theme app embed](#enable-the-theme-app-embed) |
| Ingest Labs Tracking Script | [Enable the theme app embed](#enable-the-theme-app-embed) — then the custom pixel if it persists |
| Data Collection Script | [Set up the Ingest Labs custom pixel](#set-up-the-ingest-labs-custom-pixel) |
| Shopify Event Tracking | [Set up the Ingest Labs custom pixel](#set-up-the-ingest-labs-custom-pixel) |
| Customer Events Pixel | [Set up the Ingest Labs custom pixel](#set-up-the-ingest-labs-custom-pixel) |
| Store Loads | [Store Loads](#store-loads) |
## Enable the theme app embed
**Alert:** Theme App Embed Disabled — *Your theme's Ingest Labs app embed is turned off. Ingest Labs Attribution is currently affected and marketing attribution is at risk.*
**What it means:** The Ingest Labs app embed is switched off in your theme, so our identity script is not loading the way it should. Tracking may still partially work, but visitor identification is degraded and attribution becomes unreliable.
This usually happens after a theme change, or when a theme is duplicated or published without the embed enabled.
**Step 1:** In your Shopify admin, open **Online Store** from the left sidebar, then click **Edit theme** on your current theme.
> 
>
> Shopify admin → Online Store, with arrows on the **Online Store** sidebar item and the **Edit theme** button.
>
> *Caption: Open Online Store, then click Edit theme on your live theme.*
**Step 2:** In the theme editor, open the **App embeds** panel using the app icon in the left toolbar.
**Step 3:** Find **Ingest Labs Extension** in the list and make sure its toggle is switched **on**.
> 
>
> Theme editor → App embeds panel, with an arrow on the **Ingest Labs Extension** toggle in the on position.
>
> *Caption: The Ingest Labs Extension embed switched on. If yours is off, click the toggle to enable it.*
**Step 4:** Click **Save**.
{% hint style="info" %}
If you have recently switched themes, enable the app embed on the newly published theme. Settings do not carry across from your previous theme.
{% endhint %}
## Set up the Ingest Labs custom pixel
**Alerts:** Data Collection Script · Shopify Event Tracking · Customer Events Pixel
**What it means:** Shopify sends storefront activity to Ingest Labs through a **custom pixel** in your Customer events settings. If that pixel is missing, disconnected, or blocked by consent settings, the events never reach us — so page views, add-to-carts and checkouts go unrecorded.
The steps below add the pixel from scratch. If a pixel named **Ingest Labs** already exists, open it and work through steps 9 to 11 to check its settings and code.
### Part 1 — Copy your code snippet from Ingest Labs
**Step 1:** Log in to [console.ingestlabs.com](https://console.ingestlabs.com).
**Step 2:** On the **Tag Manager** card, click **Launch**.
> 
>
> Ingest Labs console products page, with the **Launch** button on the Tag Manager card highlighted.
>
> *Caption: Launch Tag Manager from the products page.*
**Step 3:** Select your Shopify project from the list. Shopify projects are marked with a **SHOPIFY** badge.
> 
>
> Tag Manager Projects list, with a Shopify-badged project highlighted.
>
> *Caption: Choose your Shopify project. Look for the SHOPIFY badge.*
**Step 4:** In the left sidebar under **Deployment**, click **Environments**, then select **production**.
> 
>
> Environments list, with arrows on the **Environments** sidebar item and the **production** row.
>
> *Caption: Open Environments and select production.*
**Step 5:** Under **SDK Setup**, choose your store's domain from the **Domain** dropdown, then click **Copy Code Snippet**.
> 
>
> SDK Setup panel showing the Domain dropdown, the Copy Code Snippet button and the snippet below it.
>
> *Caption: Select your domain, then copy the code snippet.*
>
> *Note: this screenshot shows a real snippet with project and organisation identifiers — consider blurring them before publishing.*
{% hint style="info" %}
This panel also has a **link** that opens your Shopify Customer events page directly, and repeats these steps. Use it to skip the navigation in Part 2.
{% endhint %}
### Part 2 — Add the pixel in Shopify
**Step 6:** In your Shopify admin, click **Settings** at the bottom of the left sidebar, then open **Customer events**.
> 
>
> Shopify admin sidebar with an arrow on **Settings**.
>
> *Caption: Open Settings from the bottom of the Shopify sidebar.*
**Step 7:** Look through the **Pixels** list for one named **Ingest Labs**. If it is not there, click **Add custom pixel**.
> 
>
> Customer events page showing the Pixels list and the **Add custom pixel** button, with the Ingest Labs pixel indicated.
>
> *Caption: The Customer events page. If no Ingest Labs pixel is listed, click Add custom pixel.*
**Step 8:** Enter **Ingest Labs** as the pixel name, then click **Add pixel**.
> 
>
> Add custom pixel dialog with "Ingest Labs" typed into the Pixel name field.
>
> *Caption: Name the pixel exactly "Ingest Labs".*
{% hint style="warning" %}
Name the pixel exactly **Ingest Labs**. Our health check looks for this pixel by name, and a different name will keep the alert firing even once everything else is correct.
{% endhint %}
**Step 9:** Under **Customer privacy**, set:
* **Permission** → **Not required**
* **Data sale** → **Data collected does not qualify as data sale**
> 
>
> Customer privacy panel with arrows on **Not required** and **Data collected does not qualify as data sale**.
>
> *Caption: Both settings must be selected for the pixel to run on every visit.*
{% hint style="warning" %}
If **Permission** is set to **Required**, the pixel only fires after a visitor accepts your consent banner — and the *Customer Events Pixel* alert will continue. Confirm these settings match your privacy policy before changing them.
{% endhint %}
**Step 10:** Paste the snippet you copied in Step 5 into the **Code** box.
> 
>
> The pixel's Code box with the Ingest Labs snippet pasted in.
>
> *Caption: Paste the copied snippet into the Code box.*
>
> *Note: this screenshot shows a real snippet with project and organisation identifiers — consider blurring them before publishing.*
**Step 11:** Click **Save** at the top of the page, then click **Connect** to activate the pixel.
## Store Loads
**What the alert says:** We could not load your storefront, so no visitor data is being collected.
**What it means:** Our checker could not reach your storefront at all. If your store is genuinely down, this is the least of the problems it indicates. If your store is up and reachable for shoppers, the check may have been blocked.
**How to fix it:**
1. Open your storefront in a browser to confirm it loads normally.
2. If it does, check whether a firewall, bot-protection service or password page is blocking automated requests.
3. If the store is reachable and unblocked, this may have been a temporary network issue — the next hourly check will confirm.
Contact support if the alert persists across several hours.
## Still seeing the alert?
The check runs **once an hour**, so allow up to an hour after making a change before the alert clears. You will receive a confirmation email when everything is working again.
If an alert continues after you have applied the fix, reply to the alert email or contact support and include the **reference code** shown at the bottom of the email — it lets us find the exact check run in our logs.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.ingestlabs.com/troubleshooting/shopify-health-check-alerts.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.