🛠️ Fix Shopify Pixel Disconnection and Script Errors

🔍 Why Does My Shopify Connection Drop?

Shopify pixel disconnections in Search Atlas are usually triggered by one of the following causes:

• Shopify theme updates: When you update or switch your storefront theme, custom pixel scripts installed by third-party apps — including Search Atlas — can be removed or overwritten automatically.
• App permission changes: If Search Atlas app permissions are revoked or expire inside your Shopify admin, the tracking pixel loses its authorisation to fire.
• Shopify Customer Privacy API changes: Shopify periodically updates its consent and cookie APIs. If your store's consent banner or privacy settings change, pixels may be blocked from loading until re-authorised.
• Script injection conflicts: Other marketing or analytics apps installed after Search Atlas can conflict with the pixel, causing it to silently fail.
• Shopify store plan changes: Downgrading your Shopify plan can restrict access to certain script injection features, breaking the connection.

⚠️ How to Tell Your Connection Has Dropped

You may notice the following signs inside Search Atlas when your Shopify pixel is disconnected:

• A red or warning status indicator next to your Shopify store in the Integrations or Connected Sites section.
• Missing or flatlined traffic and conversion data on your dashboard for the affected store.
• Alerts or notification banners prompting you to reconnect your Shopify account.

If you manage multiple stores — such as amberandhue.com.au and hyundaipower.com.au — a single theme update or permission change affecting one store can sometimes trigger disconnection flags across all linked properties simultaneously. Always check every connected store when you receive a disconnection alert.

🔧 Step-by-Step: Reconnect Your Shopify Store

1. Log in to Search Atlas and navigate to Settings > Integrations (or Connected Sites, depending on your plan).
2. Locate the disconnected Shopify store. You will see a warning icon or a Reconnect button next to the store URL.
3. Click Reconnect and follow the OAuth authorisation flow. You will be redirected to your Shopify admin to approve the permissions request.
4. Once redirected back to Search Atlas, confirm the store status changes to Connected (green indicator).
5. Repeat this process for each disconnected store individually. Reconnecting one store does not automatically restore others.
6. After reconnecting, navigate to your Shopify Admin > Online Store > Themes and confirm the Search Atlas script snippet is present in your active theme's theme.liquid file or via the Shopify Web Pixels Manager. If it is missing, proceed to the manual script step below.

📋 Manually Re-adding the Search Atlas Pixel Script

If the pixel script was removed by a theme update, you may need to add it back manually:

1. In Search Atlas, go to Settings > Integrations and open your Shopify store details. Copy the unique pixel script snippet provided for your store.
2. In your Shopify Admin, go to Online Store > Themes. Click Actions > Edit Code on your active theme.
3. Open the theme.liquid file and paste the copied script immediately before the closing </head> tag.
4. Click Save. The pixel should begin firing within a few minutes.
5. Return to Search Atlas and verify that data is flowing by checking the real-time or recent activity panel for the store.

🛡️ How to Prevent Future Disconnections

Follow these best practices to keep your Shopify connections stable:

• Test in a staging theme first: Always preview theme updates on a duplicate theme before publishing. This lets you verify the pixel script survives the update.
• Use Shopify Web Pixels where available: Shopify's Web Pixels Manager is more resilient to theme changes than script injection into theme.liquid. If Search Atlas supports this method for your plan, use it.
• Review permissions after plan changes: Any time you change your Shopify subscription plan, revisit Search Atlas integrations to confirm permissions are still active.
• Monitor your Search Atlas dashboard regularly: Check the Integrations status section at least once a week if you manage multiple stores.
• Audit third-party apps before installing: Before adding new marketing or analytics apps to Shopify, check that they do not override or remove existing pixel scripts.

💬 Still Need Help?

If you have followed the steps above and your Shopify store is still showing as disconnected, or if data is not appearing after reconnection, our team is ready to investigate. 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.