> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomwize.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Your Shopify Store

> Step-by-step guide to connecting your Shopify store to EcomWize Builder.

To publish landing pages to your Shopify store, you need to connect it to EcomWize Builder. The connection process walks you through creating a custom app on Shopify and linking it to your EcomWize account.

## 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.

<Steps>
  <Step title="Step 1: Enter your Shopify Store URL">
    Go to the **Stores** page from your EcomWize dashboard. Click the **Connect Store** button.

    <Frame caption="The store connection wizard - Step 1: Enter your Shopify store URL.">
      <img src="https://mintcdn.com/ecomwize/lzHHkkDEjyGaRyRC/images/store-connection-wizard.png?fit=max&auto=format&n=lzHHkkDEjyGaRyRC&q=85&s=44c3f3f2f0b9bd016f4c609b33a7020d" width="3446" height="1904" data-path="images/store-connection-wizard.png" />
    </Frame>

    Enter your Shopify admin store URL. You can paste it in either format:

    * `https://admin.shopify.com/store/your-store-name`
    * `your-store.myshopify.com`

    To find this URL:

    1. Go to your **Shopify Store Admin**
    2. Click on the **Home button** from the sidebar
    3. Click on your browser's URL bar, **copy the URL**, and paste it into the field

    EcomWize will automatically extract your shop domain from either format.
  </Step>

  <Step title="Step 2: Create App">
    Open the **Shopify Dev Dashboard** by visiting [dev.shopify.com/dashboard](https://dev.shopify.com/dashboard) and click the **Create app** button.
  </Step>

  <Step title="Step 3: Fill out the app details">
    Inside the opened modal/popup:

    1. In the **name** field, enter: `EcomWize`
    2. Click the **Create** button
    3. In the **App URL** field, enter: `https://app.ecomwize.io/`
    4. Uncheck the **Embed app in Shopify admin** checkbox
  </Step>

  <Step title="Step 4: Configure Access and Release">
    In the opened page:

    1. Find the **Access** card
    2. Check the **Use legacy install flow** checkbox
    3. Complete the **Redirect URLs** field with the value shown in EcomWize (copy it using the copy button)

    <Warning>
      Make sure you check the **Use legacy install flow** checkbox and complete the **Redirect URLs** field. Otherwise you will not be able to connect your store.
    </Warning>

    4. Click the **Release** button located at the bottom right corner
    5. In the opened modal/popup, leave the fields empty and click **Release**
  </Step>

  <Step title="Step 5: Enter Client ID and Secret">
    1. From the **left sidebar**, click on **Settings** -- you will see the **Client ID** and **Secret** fields at the top of the page
    2. Copy and paste both values into the corresponding fields in EcomWize
    3. Click **Connect Store** to complete the connection

    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.

    <Frame caption="The Shopify app authorization screen for EcomWize.">
      <img src="https://mintcdn.com/ecomwize/lzHHkkDEjyGaRyRC/images/shopify-install-app.jpg?fit=max&auto=format&n=lzHHkkDEjyGaRyRC&q=85&s=afc760eec21610bf77d97525541572be" width="1280" height="982" data-path="images/shopify-install-app.jpg" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Each step includes a video walkthrough. If you are unsure about any step, watch the video before proceeding.
</Tip>

## 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.

<Frame caption="The Stores page showing a connected Shopify store.">
  <img src="https://mintcdn.com/ecomwize/lzHHkkDEjyGaRyRC/images/stores-page-connected.png?fit=max&auto=format&n=lzHHkkDEjyGaRyRC&q=85&s=d276a80e30500445aa3f7d5d15ba4fe1" width="3452" height="1896" data-path="images/stores-page-connected.png" />
</Frame>

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

<Warning>
  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.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Store URL not recognized">
    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.
  </Accordion>
</AccordionGroup>

<Note>
  If you encounter any other issues during the connection process, contact us at **[support@ecomwize.io](mailto:support@ecomwize.io)** and we will help you get connected.
</Note>