Skip to main content
To publish landing pages to your Shopify store, you need to connect it to EcomWize Builder. The connection uses a Shopify custom app that you create in your Shopify Partners dashboard, which gives EcomWize secure access to your store’s theme and page APIs.

​
Prerequisites

Before you begin, make sure you have:
  • A Shopify store (any plan)
  • Access to the Shopify Partners dashboard (or admin access to create custom apps)
  • An EcomWize Builder account on the Starter or Pro plan (publishing requires a paid plan)

​
Connecting Your Store

The connection process uses a 5-step guided wizard with video tutorials for each step.
1

Navigate to Stores

Go to the Stores page from your EcomWize dashboard. Click the Connect Store button to open the connection wizard.
2

Enter your store URL

Enter your Shopify store URL. You can use either format:
  • your-store.myshopify.com
  • https://admin.shopify.com/store/your-store
The wizard will automatically extract your shop domain from either format.
3

Create a custom app in Shopify

Follow the video tutorial in the wizard to create a custom app in your Shopify admin:
  1. Go to Settings > Apps and sales channels > Develop apps
  2. Click Create an app and give it a name (e.g., “EcomWize”)
  3. Configure the app’s API scopes (the wizard shows exactly which scopes are needed)
  4. Set the redirect URL to the one shown in the wizard
4

Enter your Client ID and Client Secret

From your Shopify custom app’s settings, copy the Client ID (API key) and Client Secret (API secret key) and paste them into the wizard fields.
5

Authorize the connection

Click Connect. You will be redirected to Shopify to authorize the app. After approving the permissions, you will be redirected back to EcomWize with your store connected.
Each step in the wizard includes a video walkthrough. If you are unsure about any step, watch the video before proceeding.

​
Managing Multiple Stores

EcomWize supports connecting multiple Shopify stores depending on your plan:
PlanMaximum Stores
Free1 store
Starter1 store
ProUnlimited stores

​
Setting the Active Store

When you have multiple stores connected (Pro plan), you need to select which store is “active.” The active store is used for:
  • Publishing pages
  • Fetching product data
  • Loading Shopify products in the builder
To change your active store, go to the Stores page and click the store you want to make active.
Only one store can be active at a time. When you publish a page, it is always published to your currently active store.

​
Verifying the Connection

After connecting, your store should appear on the Stores page with a connected status. You can verify the connection is working by:
  1. Opening any page in the builder
  2. Going to Page Settings
  3. Checking that your store appears in the Store dropdown
  4. Trying to search for products (if your store has products)

​
Disconnecting a Store

To disconnect a store:
  1. Go to the Stores page
  2. Find the store you want to disconnect
  3. Click the disconnect or remove option
  4. Confirm the disconnection
Disconnecting a store does not unpublish any pages you have already published to that store. Published pages will remain live on Shopify until you manually remove them from Shopify’s theme editor or unpublish them before disconnecting.

​
Troubleshooting

This error means the security signature from Shopify does not match. Common causes:
  • The Client Secret you entered is incorrect — double-check it in your Shopify app settings
  • You are using credentials from a different app — make sure you are copying from the correct custom app
  • Try deleting the app in Shopify and creating a new one with fresh credentials
This occurs when the OAuth session state does not match between the initial request and the callback. 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 the wizard and start the connection process again from the beginning
This means EcomWize received the authorization code from Shopify but could not exchange it for an access token. Possible causes:
  • The Client ID or Client Secret is incorrect
  • The custom app has been deleted or its credentials have been rotated
  • Network issues between EcomWize servers and Shopify
  • Solution: Verify your credentials, ensure the app exists in Shopify, and try again
Make sure your store URL is in one of these formats:
  • your-store.myshopify.com
  • https://admin.shopify.com/store/your-store
Custom domains (e.g., www.yourbrand.com) are not supported for the connection. Use your .myshopify.com URL instead.
If you see permission errors after connecting, the custom app may not have all required API scopes. Go back to your Shopify app settings, update the scopes as shown in the wizard, and reinstall the app.