Shopify Health Check Alerts
What the automated Shopify integration health alert emails mean, and how to fix each issue on your store.
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:
Theme App Embed Disabled
Ingest Labs Tracking Script
Enable the theme app embed — then the custom pixel if it persists
Data Collection Script
Shopify Event Tracking
Customer Events Pixel
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.
If you have recently switched themes, enable the app embed on the newly published theme. Settings do not carry across from your previous theme.
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.
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.
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.
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".
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.
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.
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.
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:
Open your storefront in a browser to confirm it loads normally.
If it does, check whether a firewall, bot-protection service or password page is blocking automated requests.
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.
Last updated