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.

If you have a Shopify connection that uses any of the fields outlined in this article, you need to take action now 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
shipping_weight	10g	10GRAMS
fulfillment_service	"manual'	None - field deprecated

What you need to do

1

Refresh your Shopify connection

This action does not create a new Shopify connection.

Refresh your Shopify connection by following these steps:

1

Go to Company settings > Connections and locate your Shopify connection.

2

Click Edit.

3

Click Refresh connection. You’ll be taken to Shopify.

4

Sign in to Shopify.

5

Accept the access scopes that Channable has requested access to.

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.

6

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.

2

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:

1

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

2

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.

If we do not support a price field for the country you want to select, please contact Support and we will assist with the setup.

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.

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.