> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/changelog/2025/january.md).
# January
{% updates format="full" %}
{% update date="2025-01-27" tags="important,info" %}
## 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.
{% endupdate %}
{% update date="2025-01-20" tags="improvement" %}
## Improved setup for feeds, collapsible navigation menu, and company settings
January 20, 2025
#### What’s changed?
In the **Feeds** setup, we’ve improved the design for the **Settings** step, making it possible for you to customize your feed more when you create it.
* There is a new **Advanced settings** section when you add a new feed, where you can edit more settings for your feed.
* The settings for **Master rule**, **Difference safety**, **Image generation safety** and **SFTP settings** can now be found here.
* The feed setup steps are now numbered 1–6 and are on the left of the feed setup, next to the main navigation.
* There are no changes to the content at each step (except for some **Settings** changes).
* When you are in your company or project in Channable, you can collapse or expand the main navigation sidebar.
* To collapse or expand the menu, click on the menu button — a “Collapse menu” or “Expand menu” tooltip will show when you hover over the button.
* **Connections** and the **Channable API** are no longer visible from the sidebar.
* To find them, click **Company settings** in the sidebar, then select the tab you need under the ‘Tools’ heading.
* **Manage Access** and **Notification Settings** are no longer visible from the sidebar.
* To find them, click **Company settings** in the sidebar, then select the tab you need under the ‘Company settings’ heading.
{% endupdate %}
{% endupdates %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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/2025/january.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.