# Shopify

In this article, you'll learn how to install the Shopify Channable app to import product data from your Shopify web shop into Channable.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You’ll need**

* A Shopify account with a webshop
* At least one [market](https://help.shopify.com/en/manual/markets-new/manage) set up in Shopify

{% hint style="warning" %}
**Important:** When setting up your market in Shopify, make sure that you click the :heavy\_plus\_sign: next to the options (e.g. the option **Catalogs -> All products**) at the **Inherited** section in order to add/save them.

<img src="/files/5R2CuEmYl8qzJjXACmYH" alt="" data-size="original">
{% endhint %}

{% hint style="warning" %}
**Important:** In Shopify, make sure your market has a **catalog assigned that contains products**. If your market has no catalog (or an empty catalog), the Shopify Markets import can fail or import no items.

Quick fix: [In Shopify, create a new catalog](https://help.shopify.com/en/manual/markets-new/catalogs) that includes **All products** (Shopify’s default) and assign it to the market.
{% endhint %}

**Good to know**

<details>

<summary><strong>Imported prices can differ from storefront currencies</strong></summary>

Channable imports the original source currency from Shopify, so price values may not reflect \[currency conversions]\(/pages/gLDjfO3nlR9Zqzjtjm1n) displayed in your storefront.

</details>

<details>

<summary><strong>Billing works a little differently for Shopify</strong></summary>

Subscriptions and add-ons related to your Shopify integration are invoiced through Shopify in USD, meaning your billing cycle might differ from our standard invoicing. All charges will appear on your Shopify invoices.

For more information about Channable payments for Shopify users, check our [detailed guide](https://helpcenter.channable.com/hc/en-us/articles/360011067100-How-Shopify-users-can-pay-for-Channable).

</details>

<details>

<summary><strong>Variant product images are imported for each product</strong></summary>

When you create variants in Shopify, we import images for all variants for that product so you can use them when setting up a channel.

For more control over which images are imported, you could:

* Create separate "parent" products in Shopify for each variant.
* Set up an import rule to filter `additional_image_links` based on a unique identifiers (e.g. size, color) in the image URL.

</details>

***

{% stepper %}
{% step %}

### Install the Channable app in Shopify

{% hint style="danger" %}

#### Temporary workaround

The Channable app is temporarily unavailable in the Shopify App Store, but you can continue with the installation.

In step 1.7, you will need to use the provided URL instead of going to the Shopify App Store.

We will restore the standard Shopify App Store flow as soon as possible.
{% endhint %}

Follow these steps to install the Channable app and connect Shopify to Channable:

1. Log into your Shopify admin account.
2. Go to **Settings** > **Domains**.
3. At **Domain**, make note of the value before `.myshopify.com`. You will need this in a later step.

**Example:** For a domain named `channabletest.myshopify.com` , you would note `channabletest`.

<figure><img src="/files/w3cxtfGkwLZcEg98Trb8" alt=""><figcaption></figcaption></figure>

4. In Channable, open the project where you want to import your product data.
5. Go to **Setup**, click **+ Set up import** and select **Shopify**. A pop-up will appear to begin your import setup.
   1. For **Label,** give your import channel a descriptive name (e.g. “Shopify data EN”).

{% hint style="info" %}
**Note:** Other details in this pop-up will be pre-filled automatically filled in after you connect to Shopify.
{% endhint %}

6. Click **Connect with Shopify markets**.
7. Copy the URL below.

<pre data-title="Installation URL" data-overflow="wrap"><code>https://admin.shopify.com/store/<a data-footnote-ref href="#user-content-fn-1">CHANGE-THIS</a>/oauth/authorize?client_id=152d37793ceb94020f844915bd18a460&#x26;redirect_uri=https%3A%2F%2Fapp.channable.com%2Fconnect%2Fshopify%2Factivate&#x26;scope=read_companies%2Cread_content%2Cread_customers%2Cread_inventory%2Cread_locales%2Cread_locations%2Cread_markets%2Cread_metaobject_definitions%2Cread_metaobjects%2Cread_orders%2Cread_products%2Cread_publications%2Cread_returns%2Cread_translations%2Cwrite_checkouts%2Cwrite_customers%2Cwrite_draft_orders%2Cwrite_order_edits%2Cwrite_orders%2Cwrite_returns%2Cread_merchant_managed_fulfillment_orders%2Cwrite_merchant_managed_fulfillment_orders%2Cread_assigned_fulfillment_orders%2Cwrite_assigned_fulfillment_orders%2Cread_third_party_fulfillment_orders%2Cwrite_third_party_fulfillment_orders%2Cread_files%2Cread_themes%2Cread_draft_orders
</code></pre>

8. Replace `CHANGE-THIS` with the value you noted earlier in Step 3.
9. Paste the updated URL into your browser to start the installation flow.
10. In Shopify, click **Install**.
11. Shopify will open your store backend to authorize the connection. In the page header, click **Install app**.
12. Once installation is complete, you'll be redirected back to Channable.
    {% endstep %}

{% step %}

### Set up your Shopify Markets import

{% hint style="warning" %}
**Important:** You must have at least one market to import items from. If you don't have any, [create one](https://help.shopify.com/en/manual/markets-new/manage) before continuing.
{% endhint %}

Continue setting up your Shopify markets import.

1. **Name**: Give your importer a clear name (e.g. ‘Shopify Markets’).
2. **Choose language:** Select any additional language(s) you want to import. The primary language is always included.
3. **Shopify Markets to import:** Select the market you want to import. If you don’t add one, we’ll import all markets by default.
4. Click **Start import**.
   {% endstep %}

{% step %}

### Set your advanced settings (optional)

After we read your product data, you’ll land on the **Edit mapping** page.

If you would like to further customize your Shopify setup (e.g. import metafields, only import active markets):

1. Click on the **Settings** tab to return to your import settings.
2. Click **Advanced settings**.
3. Go through each tab and apply your preferred settings, clicking **Save** after each change.

{% hint style="info" %}
**Note**: Enabling advanced settings may slow down your import update speed.
{% endhint %}

<details>

<summary><strong>Advanced setting options</strong></summary>

**Additional fields**

* **Include translated metafields:** Enable to include translated values for metafields.
* **Metafields:** Enable to import custom fields which store additional information related to your items.

**Import filters**

* **Collection ID:** Input an ID to only import items from that specific collection ID. Find the ID in the URL of the collection page in Shopify e.g.

  `https://my-shop-name.myshopify.com/admin/collections/123456789`
* **Only import active markets:** Enable to only import active markets.
* **Only import active items:** Enable to only import active (visible, available for sale) items.

</details>
{% endstep %}

{% step %}

### Map your product data to project fields

This page displays fields retrieved from your Shopify account (e.g. price, description, title).

In this step, you match your imported fields to Channable's standardized project fields. Channable does most mapping automatically, but it's important to review and adjust before importing.

{% hint style="info" %}
Tip: Want to learn more about how import mapping works in Channable? Read our [dedicated guide on mapping](/get-started/getting-started/fields-in-channable/field-mapping-in-channable.md).
{% endhint %}

<figure><img src="/files/nalbWoHx0MA2QrQOnql5" alt=""><figcaption></figcaption></figure>

1. **Compare and adjust mapping.**
   * Review your **Import fields** against Channable's matched **Project fields**. If a field was matched incorrectly, click on the field to select a different field.
2. **Check and correct field types.**
   * Check that the right field type is assigned to your project fields. If a field has the wrong type, click **Edit** next to the field, select the correct type in the dropdown, and click **Save & Import**.
3. **Exclude fields (optional).**
   * To exclude a field from being included in your product data, click the checkbox in the **Select** column for that field and click **Do not import selected fields**.

**Note:** If you have several markets set up in Shopify, check that any market-specific fields (like price\_netherlands or title\_fr) are mapped to the right field type.

Once you've finished mapping, click **Save & Import** to start importing your Shopify product data.
{% endstep %}

{% step %}

### Review your imported items

After your product data has finished importing:

* Go to the **Items** page to view your imported products.
* Click on an item to see detailed information.

<figure><img src="/files/ab6d27ddeac81e9edc339564a8ec4f014d676f5d" alt=""><figcaption></figcaption></figure>

Your Shopify import is now successfully set up! You can now use this product data to create and optimize Feeds, Marketplaces, Shopping Ads, and more in Channable.
{% endstep %}
{% endstepper %}

[^1]: Replace this with the value noted in Step 3.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
