Shopify Custom Pixel Not Firing: How to Test and Fix It
Quick fix
Shopify custom pixel not firing usually means it isn't connected, consent is holding it back, or its code has an error. Check Settings, Customer events shows Connected, then test with the Shopify Pixel Helper. Look for a red dot, an awaiting consent message, and uncaught errors, and review your customer privacy settings.
- Check Customer events shows the pixel as Connected.
- Open the Shopify Pixel Helper and look for green and red dots.
- Look for uncaught errors in the helper.
- Check customer privacy settings and consent.
Can't fix it yourself? Send me the details
What this error means
A custom pixel is your own JavaScript that listens to Shopify customer events. It only runs when it's connected, the code subscribes correctly, and customer privacy settings allow it to load.
Why it happens
1The pixel is not connected
A disconnected pixel does not track events.
How to tell if this is you: It sits under Disconnected pixels.
2Waiting for consent
Customer privacy settings can hold the pixel until consent is given.
How to tell if this is you: The helper says Pixel is awaiting consent.
3Consent not synced from a third-party tool
A consent app must sync with the Customer Privacy API.
How to tell if this is you: The pixel does not fire even after consent.
4A code error
The callback or top-level code can fail.
How to tell if this is you: The helper shows a red dot or an uncaught error.
5A setup the helper cannot test
The helper does not work on headless or private-mode stores.
How to tell if this is you: The helper will not run.
How to fix it
Connect the pixel
For: The pixel is not connected
- Check the Status column says Connected, and connect it if not.
Handle consent
For: Waiting for consent, Consent not synced from a third-party tool
- Review customer privacy settings and give consent in the cookie banner.
- Clear browser cookies to reset the banner.
- If you use a consent app, make sure it syncs through the Customer Privacy API.
Test with the helper
For: A code error, A setup the helper cannot test
- Use the Shopify Pixel Helper, testing one pixel at a time.
- Fix errors the helper shows, then save and reopen it to retest.
- Remember event logs clear when you change page.
How long it takes
Shopify doesn't publish a timeline for this.
How to stop it happening again
- Test every custom pixel change with the helper before relying on it.
- Review the Permission setting for each pixel.
- Remember Shopify does not support custom pixel code, so keep your own notes.
From my desk
I check three things in order. Is the pixel actually connected in Customer events? What does the Shopify Pixel Helper show, and is there a red dot or an error? Is it waiting for consent? Most dead pixels are disconnected, blocked by a consent setting, or throwing a small JavaScript error.
Muhammed Abdul Kalam
When to get help
- You've worked through the checks and the data still isn't right.
- The tracking was set up by an agency, app or developer who is no longer available.
- Sales or ad spend are affected and every day without clean data costs money.
Stuck on this? Send me the details.Tell me what the platform shows and what you've tried so far.
Send me the detailsFAQs
How do I know a custom pixel is connected?
The Status column in Customer events shows Connected.
What does a red dot mean?
The event was subscribed to but the callback function failed.
What is "Pixel is awaiting consent"?
Customer privacy settings are holding the pixel until consent is given.
Can I test several pixels at once?
No. Test only one custom pixel at a time.
Does Shopify support my custom code?
No. Shopify does not support adding or using custom pixels.