# January 27, 2025: Shopify updates

January 27, 2025

As of the 27th of January, Channable will migrate to Shopify’s new API, as the current version is being [deprecated](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model#whats-changing).

If you have a Shopify connection that uses any of the fields outlined in this article, you need to [take action now](#h_01JJ4HPAQCC0YZT7ZYH66XSR3D) to prevent product or project issues.

#### Affected fields

| Channable field name    | Old format - example value  | New format - example value                                        |
| ----------------------- | --------------------------- | ----------------------------------------------------------------- |
| created\_at             | '2020-08-13T09:50:02-04:00' | '2020-08-13T13:50:02Z'                                            |
| published\_at           | '2020-08-13T09:50:02-04:00' | '2020-08-13T13:50:02Z'                                            |
| parent\_created\_at     | "web"                       | None - field deprecated                                           |
| published\_scope        | "web"                       | None -  field deprecated                                          |
| grams                   | 10                          | None -  field deprecated                                          |
| inventory\_management   | "shopify"                   | None -  field deprecated                                          |
| price\_{currency\_code} | '21.50'                     | [The deprecated `price_eur` field](#h_01JJ4HPAQCRZ5BA07WQKP199DX) |
| shipping\_weight        | 10g                         | 10GRAMS                                                           |
| fulfillment\_service    | "manual'                    | None -  field deprecated                                          |

### What you need to do

{% stepper %}
{% step %}

#### Refresh your Shopify connection

{% hint style="info" %}
This action does not create a new Shopify connection.
{% endhint %}

Refresh your Shopify connection by following these steps:

{% stepper %}
{% step %}
Go to **Company settings** > **Connections** and locate your Shopify connection.
{% endstep %}

{% step %}
Click **Edit**.
{% endstep %}

{% step %}
Click **Refresh connection**. You’ll be taken to Shopify.
{% endstep %}

{% step %}
Sign in to Shopify.
{% endstep %}

{% step %}
Accept the access scopes that Channable has requested access to.

{% hint style="warning" %}
If you do not receive a prompt to grant permission when you are redirected to Shopify, verify you have the right permissions in Shopify as described [here](https://help.shopify.com/en/manual/your-account/staff-accounts/staff-roles/permissions/permissions-descriptions).
{% endhint %}
{% endstep %}

{% step %}
You will be redirected back to Channable. Click **Create** to replace your existing Shopify connection with the new one.

Your Shopify connection will be refreshed. If your connection refresh is successful, "read\_locations" will be present at the field **Scope**.

<figure><img src="https://content.gitbook.com/content/Celgbro04804WOVz6ZV0/blobs/vsTXINe13OpwRYCrQ5c5/24157966824082" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}

#### Re-map or edit affected fields

**Note:** This step can only be completed from the 27th of January.

Once you have refreshed your Shopify connection, you need to re-map or edit the affected fields. The exact action depends on which fields you use and how the Shopify API update changed them.

#### The deprecated `price_currency` field

The fields for price that had the structure `price_currency` are now structured as `price_country`. `price_usd` and `price_gbp` will be imported automatically and Channable will automatically re-map these fields. You only need to complete the steps below if you use the `price_eur` field or any other custom price currency field.

<figure><img src="https://content.gitbook.com/content/Celgbro04804WOVz6ZV0/blobs/BcpDKae8GELG4AoUchx0/24132112047122" alt=""><figcaption></figcaption></figure>

Follow one of the options below:

{% stepper %}
{% step %}

###

Go to **Setup** and locate your Shopify import.\
In the ‘Edit’ column, click **Edit mapping**.\
Map one of the new currency fields to each of the old fields. Each 'Project field' can only be mapped to one 'Import field'.
{% endstep %}

{% step %}

###

Find all of the locations where the deprecated `price_eur` field is in use.\
Each time `price_eur` is used, select one of the new `price_{country_code}` fields.

{% hint style="info" %}
If we do not support a price field for the country you want to select, please [contact Support](https://helpcenter.channable.com/hc/en-us/articles/360016311759-How-can-I-contact-Channable) and we will assist with the setup.
{% endhint %}
{% endstep %}
{% endstepper %}

#### Other deprecated fields

The following fields have been deprecated by the update to the Shopify API:

* published\_scope
* grams
* inventory\_management
* price\_{currency}
* fulfillment\_service

These fields will be automatically removed from any Shopify imports, so you do not need to re-map them.

However, if these fields are used in any rules / AI rules / exports, you will need to modify or remove them from those places. Otherwise, the export / rule / AI rule will fail when the Shopify API migration takes place.
{% endstep %}
{% endstepper %}

#### New value formatting for some fields

The values of the following fields will be automatically reformatted:

* `created_at`, `published_at`, `parent_created_at`: Values will no longer be localized, but will be in the UTC timezone. Example: '2020-08-13T09:50:02-04:00' → '2020-08-13T13:50:02Z'.
* `shipping_weight`: Weight notation will no longer be abbreviated, but written out in all caps. Example: "10g" → "10GRAMS", "2kg" → "2KILOGRAMS".

Note: You do not need to edit or re-map these fields — the changes will be applied automatically.