# 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**.
{% 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.
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.
---
# 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/changelog/january-2025/january-27-2025-shopify-updates.md?ask=
```
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.