This article walks you through correctly connecting a Shopify store to the Content Management (CM) Connector, resolving the common 404 token exchange error, and explains your options if you'd like to change your subscription or request a refund.
✅ Before You Begin
To connect Shopify to the CM Connector, make sure you have the following ready:
- Admin access to your Shopify store (you must be the store owner or have staff permissions to install apps).
- Your exact store domain in the format
your-store.myshopify.com. - An active Search Atlas plan that includes the CM Connector.
A note on Shopify authentication: Shopify deprecated the legacy custom-app API token method on January 1, 2026. The CM Connector now supports two authentication schemes — a manually entered access token and OAuth2 (the "Connect/authorize" flow via Shopify). If you previously connected with a manual API token and the connection now fails, use the OAuth authorize flow described below.
🔌 How to Connect Your Shopify Store
- In Search Atlas, click your avatar in the top-right corner, then go to Settings → CMS Connectors (tab) and choose Shopify as your platform.
- Enter your store domain. Use the
your-store.myshopify.comformat, not a custom domain such aswww.yourbrand.com. Using a custom domain is the most common cause of connection failures. - Click Connect. You'll be redirected to Shopify to authorize the app.
- Log in to Shopify if prompted, then click Install to approve the connection.
- You'll be returned to Search Atlas with your store marked as connected.
After connecting, confirm Shopify appears as the active connector in the synchronization panel. If the panel still shows WordPress publishing options or a "Not Synced" status, the store did not finish connecting — remove the connection and reconnect using the steps above. (A bug that caused the system to fall back to WordPress publishing when Shopify wasn't fully authorized was fixed in March 2026.)
🛠️ Fixing the "404 Token Exchange Error"
A 404 token exchange error appears when Shopify cannot complete the secure handshake that authorizes the CM Connector. This is almost always a configuration issue, not a problem with your account. Work through these checks in order:
1. Confirm the domain format
Enter only the .myshopify.com address. Custom domains, URLs with https://, trailing slashes, or extra paths (for example /admin) will cause the handshake to fail. Re-type the domain exactly as it appears in your Shopify admin under Settings > Domains (look for the "myshopify.com" address).
2. Verify your Shopify permissions
You must be signed in to Shopify as the store owner or as staff with app-installation rights. If you don't see an Install button during authorization, ask your store owner to grant the necessary permissions or complete the connection.
3. Complete authorization in one session
The token exchange must finish within a short window. If you leave the Shopify approval page open too long, switch accounts midway, or close the tab before clicking Install, the token expires and returns a 404. Start the process again from the CM Connector and approve the app promptly.
4. Clear blockers in your browser
- Disable ad blockers or privacy extensions that may interrupt the redirect.
- Allow third-party cookies for Search Atlas and Shopify.
- Try an incognito/private window or a different browser.
5. Make sure you're logged into the correct Shopify account
If you manage multiple stores, your browser may default to a different one. Log out of all Shopify sessions, then start the connection again and sign in to the specific store you want to link.
6. Reconnect
After making any change above, return to the CMS Connectors, remove the failed connection if one was created, and start fresh. Most 404 errors clear once the domain format and permissions are correct.
If the error persists after all six steps, contact our support team and include your .myshopify.com domain and a screenshot of the error. This helps us resolve the issue faster.
⚠️ Seeing a "401 Unauthorized" instead of a 404?
A 401 error is different from the 404 token exchange error: it means Shopify is rejecting credentials that were valid before. This typically happens when the Shopify app was uninstalled and reinstalled, or when the store's API token was regenerated, which invalidates the stored credentials. Search Atlas now flags these connections with an invalid-credential status and stops retrying automatically — to fix it, reconnect the store (or re-enter the token) so a fresh, valid credential is saved.
💳 Managing Your Subscription
If the platform feels complex or the plan no longer fits your needs, you have options before cancelling. Many customers find that a guided onboarding session or a smaller plan resolves their concerns.
Downgrading to a different plan
- Go to Avatar (top-right) > Billing (Plans & Top-ups).
- Select Change Plan and choose the plan that fits your budget and feature needs.
- Confirm the change. Downgrades usually take effect at the start of your next billing cycle, so you keep current features until then.
If you're unsure which plan is right, reach out and we'll recommend the best fit based on how you use Search Atlas.
Charged through the Shopify App Store but can't access the app?
If you subscribed via the Shopify App Store, were charged successfully, but Search Atlas keeps redirecting you to the pricing/subscribe page, your subscription may not have provisioned on our side. Don't request a refund as the first step — contact our support or billing team with your account email and the charge date so we can locate the Shopify subscription record and provision your access manually. (A provisioning fix for this scenario was released in May 2026; if you still hit it, support can resolve it directly.)
Requesting a refund
Refund eligibility depends on your plan type, billing cycle, and how long ago you were charged. To request a refund:
- Contact our support or billing team through the in-app chat or your account email.
- Include your account email, the charge date, and the reason for the request.
- Our team will review your request against our refund policy and respond with the available options.
Submitting a request does not guarantee a refund, but we review every case individually and will always explain the outcome.
🙋 Need More Help?
Before cancelling due to complexity, we encourage you to book a free onboarding or training session. Our team can walk you through the CM Connector and the features included in your plan so you get full value from your subscription. Contact support any time through the in-app chat or your account dashboard.