🔍 What Is This Issue?
If your Shopify store's pixel connection has dropped in Search Atlas, a Shopify pixel version update is the most common cause. When Shopify releases a new pixel version, the previously installed tracking script can become invalid, breaking the connection between your store and Search Atlas. This affects all stores using the integration, including scenarios where multiple domains disconnect at the same time.
This article walks you through why it happens and how to fix it by replacing the outdated script with the current version.
⚠️ Common Symptoms
- One or more Shopify stores show a Disconnected status in Search Atlas.
- Tracking data stops updating or shows a gap starting from a recent date.
- Multiple stores owned by the same account disconnect simultaneously.
- The connection was working correctly before a recent Shopify platform update.
🧠 Why This Happens
Shopify periodically updates its Customer Pixel framework. When a new pixel version is released, scripts built on the previous version are no longer recognised as valid by Shopify's tracking infrastructure. The connection is not lost due to anything you changed — it is a platform-side version change that requires you to replace the installed script with an updated one generated from Search Atlas.
🔧 How to Fix It
Follow these steps for each affected Shopify store.
- Log in to Search Atlas and navigate to the Integrations section from the top-right avatar → Settings → Integrations.
- Locate the disconnected Shopify store and click Reconnect or Manage Integration.
- Search Atlas will generate a new pixel script based on the latest Shopify pixel version. Copy this script to your clipboard.
- Open your Shopify Admin for the affected store.
- Go to Settings → Customer Events.
- Find the existing Search Atlas pixel script. Click on it to open the editor.
- Delete the entire contents of the existing script field.
- Paste the new script you copied from Search Atlas into the field.
- Click Save.
- Return to Search Atlas and verify the store status has changed to Connected. This may take up to five minutes to confirm.
Repeat steps 4–10 for every disconnected Shopify store.
✅ How to Confirm the Fix Worked
- The store displays a Connected status in the Search Atlas Integrations panel.
- Tracking events begin appearing in your reports within 24 hours.
- No error banners are shown against the store in the dashboard.
🛡️ How to Prevent Future Disconnections
- Check the Search Atlas status banner when you notice a drop in tracking data — platform-wide pixel version changes will often be flagged there first.
- After any Shopify platform announcement about Customer Pixel updates, proactively refresh your script using the steps above before a disconnection occurs.
- If you manage multiple Shopify stores in Search Atlas, check all of them when one disconnects, as version updates affect all stores at the same time.
💬 Need More Help?
If you have completed the steps above and your store still shows as disconnected, or if you are unsure which script version to use, If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.