If you're unable to complete the Shopify integration setup, your issue is typically one of the following. Start with the most common cause and work through each section until resolved.
1. App Not Installed (Most Common)
The integration requires the Shopify dev app to be installed. This is the most frequent cause of setup failures.
To fix this:
Go to your Shopify dev dashboard and make sure the app is installed. Check that the install value is set to 1.
If install is not set to 1, the app has not been installed. Reinstall the app and check again.
2. Wrong Shopify Scopes
The dev app must be configured with the correct Shopify API scopes. If the scopes are missing or incorrect, the integration will fail.
To fix this:
Go to your dev app in the integration settings and verify that all required Shopify scopes are enabled.
If any scopes are missing or incorrect, update them to match the required scopes for this integration.
3. Incorrect Subdomain
Your Shopify subdomain is not the same as your website's domain. You can find it in the Domains tab of your Shopify admin — it always follows the format storename.myshopify.com.
To fix this:
In your Shopify admin, go to Settings → Domains to find your Shopify subdomain (e.g. storename.myshopify.com).
Enter this subdomain in the integration setup — do not use your custom website domain (e.g. www.mystore.com).
4. 'Develop App' Button Not Showing
If you can't see the option to create a dev app in Shopify, you don't have the required permissions to create and install apps on this store.
To fix this:
Contact the owner of your Shopify store and request permissions to create and install apps.
Once permissions are granted, return to the setup and create your dev app.