# 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.
{% 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 %}

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2F9XOaS1CfhaIuwObOxo73%2Fimage.png?alt=media&#x26;token=b84e2fc2-89c1-46e9-be1e-856e716e49c2" alt=""><figcaption></figcaption></figure>

**Good to know**

* **Currency discrepancy:** Channable imports the original source currency from Shopify, so price values may not reflect [currency conversions](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/shopify/currency-discrepancies-in-shopify-imports) displayed in your storefront.
* **Billing differences:** 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).
* **Variant product images:** 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.

**How to get more control over which images Channable imports**

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.

{% stepper %}
{% step %}

### Install the Channable app in Shopify

Follow these steps to install the Channable app from the Shopify App Store:

1. In Channable, open the project where you want to import your product data.
2. 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 %}

3. Click **Connect with Shopify markets**. You'll be redirected to the **Channable** app page in the Shopify App Store.

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FW6Z8Z9lYcPHhVXJ90mYr%2F27659373332498?alt=media&#x26;token=8a203a27-43cb-416e-87cf-583a5f979694" alt=""><figcaption></figcaption></figure>

4. In the Shopify App Store page, click **Install**.
5. You'll be redirected to your Shopify store's backend to authorize the connection. In the page header, click Install app.
6. 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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/field-mapping-in-channable).
{% endhint %}

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2F6yCsJmSm5pdTTF5DwdNZ%2Finstructor_7u6jffr8fr7ks9ag5d1bwagc1_public_1751372530_mapping-manual.1751372530671.gif?alt=media&#x26;token=4c93b04d-5365-4863-93ed-21aee5e5fbf8" 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="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2Fo88t3twFoceB9cYgzV49%2F27659373335186?alt=media&#x26;token=8596289b-a359-4bbe-bdf7-c7f2c18c0f4f" 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 %}