Skip to main content

​
Overview

Connecting your Shopify store to EcomWize allows you to publish landing pages directly to your Shopify theme. The connection uses Shopify’s OAuth flow and requires API credentials from a custom app in your Shopify Partners dashboard.
You need a Shopify Partners account or admin access to the store to create the required API credentials. If you are working on behalf of a client, ask them to add you as a collaborator or create the custom app themselves.

​
Connect a store

1

Navigate to the Stores page

From the EcomWize dashboard, click Stores in the left sidebar. This page shows all your connected stores and lets you add new ones.
2

Click Connect Store

Click the Connect Store button in the top right corner. This opens the connection wizard, which will guide you through each step with video instructions.
3

Create a custom app in Shopify Partners

The wizard will walk you through creating a custom app in your Shopify Partners dashboard. You will need to:
  1. Go to partners.shopify.com and log in
  2. Navigate to Apps and click Create app
  3. Choose Create app manually
  4. Give your app a name (e.g., “EcomWize”)
  5. Set the App URL and Allowed redirection URL as shown in the wizard
Make sure you copy the Allowed redirection URL exactly as shown in the wizard. An incorrect redirect URL will cause the OAuth authorization to fail.
4

Get your API credentials

After creating the app in Shopify Partners, you will need two pieces of information:
  • Client ID — Found in the app’s overview page under “Client credentials”
  • Client Secret — Also found under “Client credentials” (click to reveal)
Copy both values carefully.
5

Enter your store domain

Back in the EcomWize wizard, enter your Shopify store domain. You can enter it in either format:
  • mystore.myshopify.com
  • https://admin.shopify.com/store/mystore
EcomWize will automatically extract the correct domain.
6

Enter your API credentials

Paste the Client ID and Client Secret you copied from Shopify Partners into the corresponding fields.
7

Authorize the connection

Click Connect to start the OAuth flow. You will be redirected to Shopify to authorize EcomWize to access your store. Review the permissions and click Install app.After authorization, you will be redirected back to EcomWize with a success confirmation.
Each step of the connection wizard includes a short video showing you exactly what to do. Watch the videos if you are unsure about any step.

​
Verify your connection

After connecting, your store will appear on the Stores page with a status badge:
  • Connected — The store is linked and ready for publishing
  • Error — There was a problem with the connection (re-authorize or check your credentials)
You can click on a connected store to see its domain and manage the connection.

​
Manage multiple stores

EcomWize supports connecting multiple Shopify stores. The number of stores you can connect depends on your plan:
PlanMax stores
Free1
Starter3
ProUnlimited
When creating or publishing a page, you select which store to publish to from a dropdown. Each page is associated with one store at a time.
If you have reached your store limit, you will be prompted to upgrade your plan when trying to connect an additional store.

​
Disconnect a store

If you need to remove a store connection:
1

Go to the Stores page

Navigate to Stores from the sidebar.
2

Click the delete button

Find the store you want to disconnect and click the trash icon or Disconnect button on the store card.
3

Confirm disconnection

A confirmation dialog will appear. Click Disconnect to confirm. This removes the stored API credentials from EcomWize.
Disconnecting a store does not remove pages that have already been published to your Shopify theme. Those pages will remain on your Shopify store until you manually delete them from your theme editor.

​
Troubleshooting

This usually means the OAuth state expired. Close the wizard, wait a moment, and try again. Make sure your browser allows cookies from EcomWize.
Double-check that you entered the correct Client ID and Client Secret from your Shopify Partners app. Even a single extra space can cause this error.
This can happen if the Shopify API credentials were rotated or the custom app was uninstalled from Shopify. Re-connect the store using the updated credentials.
In Shopify Partners, go to Apps, click on your custom app, and look under the Client credentials section on the app overview page.