Prerequisites
Before you begin, make sure you have:- A Shopify store (any plan)
- An EcomWize Builder account
Connecting Your Store
The connection process uses 5 simple steps with video tutorials for each step.Step 1: Enter your Shopify Store URL
Go to the Stores page from your EcomWize dashboard. Click the Connect Store button.
Enter your Shopify admin store URL. You can paste it in either format:

https://admin.shopify.com/store/your-store-nameyour-store.myshopify.com
- Go to your Shopify Store Admin
- Click on the Home button from the sidebar
- Click on your browser’s URL bar, copy the URL, and paste it into the field
Step 2: Create App
Open the Shopify Dev Dashboard by visiting dev.shopify.com/dashboard and click the Create app button.
Step 3: Fill out the app details
Inside the opened modal/popup:
- In the name field, enter:
EcomWize - Click the Create button
- In the App URL field, enter:
https://app.ecomwize.io/ - Uncheck the Embed app in Shopify admin checkbox
Step 4: Configure Access and Release
In the opened page:
- Find the Access card
- Check the Use legacy install flow checkbox
- Complete the Redirect URLs field with the value shown in EcomWize (copy it using the copy button)
- Click the Release button located at the bottom right corner
- In the opened modal/popup, leave the fields empty and click Release
Step 5: Enter Client ID and Secret
- From the left sidebar, click on Settings — you will see the Client ID and Secret fields at the top of the page
- Copy and paste both values into the corresponding fields in EcomWize
- Click Connect Store to complete the connection

Managing Multiple Stores
EcomWize supports connecting multiple Shopify stores depending on your plan:| Plan | Maximum Stores |
|---|---|
| Free | 1 store |
| Starter | 1 store |
| Pro | Unlimited stores |
Verifying the Connection
After connecting, your store should appear on the Stores page with a connected status.
- Opening any page in the builder
- Going to Page Settings
- Checking that your store appears in the Store dropdown
- Trying to search for products (if your store has products)
Disconnecting a Store
To disconnect a store:- Go to the Stores page
- Find the store you want to disconnect
- Click the disconnect or remove option
- Confirm the disconnection
Troubleshooting
State mismatch error
State mismatch error
This can happen if:
- You took too long to authorize (the session expired)
- You opened the authorization link in a different browser or tab
- Solution: Close and start the connection process again from the beginning
Token exchange failed
Token exchange failed
Possible causes:
- The Client ID or Secret is incorrect
- The custom app has been deleted or its credentials have been rotated
- Solution: Verify your credentials, ensure the app exists in Shopify, and try again
Store URL not recognized
Store URL not recognized
Make sure your store URL is in one of these formats:
your-store.myshopify.comhttps://admin.shopify.com/store/your-store
www.yourbrand.com) are not supported for the connection. Use your .myshopify.com URL instead.If you encounter any other issues during the connection process, contact us at [email protected] and we will help you get connected.