Fix the most common Search Atlas Shopify connector failures — loading glitches, page-load timing issues, 410 Gone errors, WordPress plugin confusion, and custom app problems — using the matching fix for each. Start with a hard-refresh and re-add, which resolves most cases.

## 📋 Overview of Shopify Connector Failures

The Search Atlas Shopify connector can fail during initial setup or after a store is already connected. This article covers the most common failure modes — temporary loading issues, page-load timing problems, 410 Gone errors, WordPress plugin confusion, and custom app failures — and gives you a clear fix for each.

## 🔄 First Fix: Hard-Refresh and Re-Add the Shopify Connector

If you can't connect your store through the plugin or custom app, or you're seeing chat disconnections and other glitches, you're likely hitting a temporary loading issue. Chat disconnections and similar glitches are usually symptoms of this same temporary loading state — not a separate problem — because the page holds a stale session that a hard-refresh clears. This fix resolves it most of the time, so try it first. If the disconnections continue even after a hard-refresh and re-add, escalate to Search Atlas support.

1. Hard-refresh the page to clear the temporary loading state: press `Ctrl+Shift+R` on Windows, or `Cmd+Shift+R` on Mac.
2. Go to **Settings → Add Connector**.
3. On **Step 1**, select **New domain** and manually type your domain name instead of selecting it from the existing list.
4. Enter your Shopify credentials and click **Submit** to create the connector.

The connector creates successfully and your Shopify store appears in your connected integrations.

## ⚠️ Connection Won't Establish (Page-Load Timing Issue)

If the Shopify connection fails immediately after you start it, a timing problem during the authorization flow may be stopping the OAuth handshake from completing. OAuth is the secure sign-in process Shopify uses to authorize the connection.

### How to fix it

1. Go to **Coworker → Connectors** (Shopify) in the left sidebar of Search Atlas.
2. Click **Connect** and wait for the Shopify authorization page to fully load before clicking anything.
3. Stay on the authorization page until it completes — keep the tab open and let the flow finish.
4. Approve all requested permissions on the Shopify side.
5. If the connection still fails, hard-refresh the page (see the First Fix section), then re-add the connector using the **New domain** option, or retry in an incognito or private window.

Once the handshake completes, Search Atlas confirms the store is connected.

## ⚠️ 410 Gone Error on a Previously Connected Store

A 410 Gone error on a store that was already connected usually means the Shopify app install was removed or the OAuth token was revoked from the Shopify admin side.

### How to fix it

1. In your Shopify admin, go to **Apps → Installed Apps** and confirm the Search Atlas app is still listed.
2. If it was removed, reinstall the Search Atlas app from the Shopify App Store.
3. Return to Search Atlas and reconnect via the left sidebar → **Coworker → Connectors** (Shopify).

After reinstalling and reconnecting, the 410 error clears and data syncing resumes.

## 🔌 WordPress Plugin Method Not Working for Shopify

The Search Atlas WordPress plugin is built for WordPress-based websites, not Shopify storefronts. Shopify does not run WordPress, so the WordPress plugin cannot connect a Shopify store.

### How to fix it

1. Use the native Shopify connector in Search Atlas instead.
2. Go to **Settings → Integrations → Shopify** and follow the OAuth connection flow described above.

The native connector is the supported path for Shopify and connects your store directly.

## 🔑 Custom App (API Key) Method Failing

If you're connecting with a Shopify Custom App (API key and secret) and the integration won't complete, a misconfigured domain, mismatched credentials, an app that isn't fully installed, a missing access scope, or an expired token is the usual cause.

### How to fix it

1. In your Shopify admin, go to **Settings → Apps and sales channels → Develop apps**.
2. Confirm your Shop Domain uses the `.myshopify.com` subdomain format (for example, `your-store.myshopify.com`), not your custom storefront domain.
3. Verify that the **Client ID** and **Client Secret** entered in Search Atlas exactly match the API credentials shown in your custom app's settings — a mismatch will block the connection.
4. Confirm the app is both **installed** and **released** in your Shopify admin. An app that is created but not installed and released will not authorize.
5. Check the app URL in your custom app configuration and set it if it is blank or incorrect (for example, `https://shopify.dev/apps/default-app-home`).
6. Open your custom app and confirm all required Admin API access scopes are enabled.
7. Verify the exact scope list against your Search Atlas connector documentation before publishing, as requirements may vary. Commonly required scopes include `read_products`, `write_products`, `read_content`, `write_content`, `read_metafields`, and `write_metafields`.
8. If any required scope is missing, add it and save the app configuration.
9. Regenerate your Admin API access token if it has expired or been revoked. Copy the new token immediately, as Shopify displays it only once.
10. Re-enter the new token in Search Atlas under the left sidebar → **Coworker → Connectors** (Shopify → Custom App).

With the correct domain format, matching credentials, a fully installed app, the correct scopes, and a valid token, the custom app connection completes and your store syncs.

## 🚫 404 Token Exchange Error

A 404 token exchange error during a custom app connection usually means Shopify can't complete the token handshake — typically because the app isn't fully installed, the app URL is wrong, or the Client ID/Secret don't match.

### How to fix it

1. Confirm the custom app is both installed and released in your Shopify admin under **Settings → Apps and sales channels → Develop apps**.
2. Verify the app URL is configured correctly (for example, `https://shopify.dev/apps/default-app-home`) — a missing or incorrect app URL will break the token exchange.
3. Double-check that the **Client ID** and **Client Secret** in Search Atlas exactly match the values in your custom app's API credentials.
4. Re-enter the credentials and retry the connection under the left sidebar → **Coworker → Connectors** (Shopify → Custom App).

Once the app is installed and released, the app URL is correct, and the credentials match, the token exchange completes successfully.

## 🔔 Known Platform-Level Issue

Search Atlas is aware of changes Shopify has made to its API token system that can affect some store connections. If you hit a connection or token error, run the First Fix steps above, and contact Search Atlas support if the issue continues.

**🎯 You now have a fix for every common Shopify connector failure — start with the hard-refresh and re-add steps, then work through the matching failure mode if needed. If a connection still won't establish after trying these, reach out to Search Atlas support so the team can investigate token-level issues.**