> 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/2026/may.md).

# May

{% updates format="full" %}
{% update date="2026-05-23" tags="important,info" %}

## ACTION REQUIRED - Renew your Shopify connection

This update follows our earlier changelog about the Shopify authentication issue, which covered the incident before renewal was available again.

{% hint style="danger" %}

### Do not uninstall the Channable app in Shopify

We are aware that [the Channable app is no longer listed in Shopify’s app marketplace](#shopify-error-message-this-app-is-not-listed-in-the-shopify-app-store.-contact-the-app-developer-for).

If the app is still installed in your Shopify store, do not uninstall it.

If you already uninstalled it, you can still [reinstall it using the method below](#i-uninstalled-the-channable-app-from-shopify).

We are working with Shopify to get the Channable app re-listed.

:point\_right: [Already uninstalled the Channable app?](#i-uninstalled-the-channable-app-from-shopify)
{% endhint %}

{% hint style="warning" %}

### ACTION REQUIRED

Complete [the steps below](#what-you-need-to-do-affected-users-only) to renew your Shopify connection:

1. [Renew your Shopify connection](#what-you-need-to-do-affected-users-only) to restore imports, item data, orders, returns, and stock updates.
2. If your Shopify import still shows **Failed** after renewal, go back to the import and click **Run now**.
3. If you use order connections, [re-send any failed orders manually](https://helpcenter.channable.com/list-advertise/orders/troubleshooting-orders/how-to-fix-resend-a-failed-order#resend-all-orders) after renewal.
4. Re-sent failed orders can take some time to appear in Shopify.

:point\_right: [Jump to the full instructions.](#what-you-need-to-do-affected-users-only)
{% endhint %}

### Overview of the issue

<details>

<summary>What’s happening?</summary>

* Some Shopify connections are affected by a Shopify authentication issue.
* If your connection is affected, you will see a notification when you log in.
* Affected projects may also show a red failed marker for Shopify imports.
* New imports of items and related data may stop syncing.
* If you use order connections, orders, returns, and stock updates may also stop syncing.
* Shopify connections can now be renewed again in Channable.

</details>

<details>

<summary>Who is affected</summary>

You are affected if either of these applies:

* You see a notification about a broken Shopify connection when you log in.
* Your Shopify import shows a red failed marker or syncing has stopped.

This applies whether or not you use an order connection.

</details>

<details>

<summary>How to check if you are affected</summary>

1. Log in to Channable.
2. Check whether you see a notification about a broken Shopify connection.
3. If you see the notification, your connection is affected.
4. If you do not see the notification, check whether your Shopify import shows a red failed marker.

</details>

## What you need to do (affected users only)

Do not uninstall your current Channable app in Shopify.

If you already uninstalled it, [reinstall it first](#i-uninstalled-the-channable-app-from-shopify).

1. [Renew your Shopify connection](#step-by-step-instructions).
2. If the import still shows **Failed**, go to **Setup > Import** and click **Run now**.
3. If you use order connections, [manually re-send any failed orders](#if-needed-re-send-failed-orders-manually).

If you see an error during renewal, or a **Failed** import status after renewal, check [Troubleshooting and error messages](#troubleshooting-and-error-messages).

### Step-by-step instructions

Follow the detailed steps below to complete the recovery flow.

{% hint style="info" %}
We’re aware the **Channable** app is no longer listed in Shopify’s app marketplace.

If the app is already installed in your Shopify store, continue with the renewal flow below.

If you already uninstalled it, [reinstall it first](#i-uninstalled-the-channable-app-from-shopify).

Do not uninstall your current Channable app in Shopify.
{% endhint %}

You can also follow [how to renew a connection](/get-started/getting-started/connections-in-channable/how-to-renew-a-connection.md) and [how to fix and resend a failed order](https://helpcenter.channable.com/list-advertise/orders/troubleshooting-orders/how-to-fix-resend-a-failed-order#resend-all-orders).

If you have trouble renewing the connection, contact <support@channable.com>.

{% stepper %}
{% step %}

### Open your Shopify connection

In Channable, go to **Company settings > Connections**.

Open your Shopify connection.
{% endstep %}

{% step %}

### Start the renewal

Click **Renew**.

{% hint style="info" %}
Do not uninstall your current Channable app in Shopify.

If Shopify prompts you to review permissions, approve the updated scopes to finish the renewal.

This only happens if required scopes changed since your last renewal.

If you do not see the **Channable** app because you uninstalled it, [reinstall it first](#i-uninstalled-the-channable-app-from-shopify).

If you see an error during renewal, check [Troubleshooting and error messages](#troubleshooting-and-error-messages).

If you still cannot renew the connection, contact <support@channable.com>.
{% endhint %}
{% endstep %}

{% step %}

### If prompted, approve the updated permissions

If Shopify shows a permissions screen, review the updated scopes and approve them to finish the renewal.
{% endstep %}

{% step %}

### Check the import status

After renewal, the authorization issue may be fixed, but the import still shows **Failed**.

Check your Shopify import status before you continue.

If the import still shows **Failed**, continue with the step below.
{% endstep %}

{% step %}

### If the import still shows failed, run it again

Go to **Setup > Import**.

If you see a red **Failed** button next to **Run now**, click **Run now**.

You may also notice the failed state on **Setup > Settings**.

If you need help with the **Failed** status or an import error message, check [Troubleshooting and error messages](#troubleshooting-and-error-messages).
{% endstep %}

{% step %}

### If needed, re-send failed orders manually

Orders that failed while the connection was down are not re-sent automatically.

After your connection is active again, [re-send any failed orders](https://helpcenter.channable.com/list-advertise/orders/troubleshooting-orders/how-to-fix-resend-a-failed-order#resend-all-orders).

{% hint style="warning" %}
Re-sent failed orders can take some time to appear in Shopify.
{% endhint %}
{% endstep %}
{% endstepper %}

### Troubleshooting

Use this section if renewal fails, your import still shows **Failed**, or Shopify shows an unexpected message.

Start with the matching error or issue below.

#### Error messages

<details>

<summary>Error message: "We could not import your items. Check the errors and try this import again"</summary>

<figure><img src="/files/D0ZEEMC2ie29Nk3ODq7w" alt=""><figcaption></figcaption></figure>

This message usually means your Shopify import failed while the connection was affected by the authentication issue.

It does not always mean there is a problem with your item data.

Even after you renew the connection, the import can still stay in a failed state until you run it again manually.

What to do:

1. Renew your Shopify connection if you have not done that yet.
2. Go to **Setup > Import** and click **Run now** if the import still shows **Failed**.
3. If the import fails again, click **View error details** and contact <support@channable.com>.

</details>

<details>

<summary>Error message: "ShopifyUnauthorizedError: User does not have access"</summary>

This error could appear when renewing a Shopify connection if your company had multiple Shopify connections. This error can also appear if your store has not switched to Shopify Markets yet.

What to do:

1. Follow the steps above to renew your Shopify connection again, even if it failed before.
2. If you still see this error after retrying, contact <support@channable.com>.

</details>

<details>

<summary>Error message: "Import status: 'Failed'"</summary>

<figure><img src="/files/scSoFy5qNzcPXpB4TamA" alt=""><figcaption></figcaption></figure>

This status usually means your Shopify import failed while the connection was affected by the authentication issue.

It does not always mean there is a problem with your item data.

Even after you renew the connection, the import can still stay in a failed state until you run it again manually.

What to do:

1. Renew your Shopify connection if you have not done that yet.
2. Go to **Setup > Import** and click **Run now** if the import still shows **Failed**.
3. If the import fails again, click **View error details** and contact <support@channable.com>.

</details>

<details>

<summary>Error message: "Channable cannot access your Shopify metafields"</summary>

This error is caused by an issue on Shopify's side.

It is separate from, but related to, the authentication issue and renewal flow on this page.

You can resolve it in two ways:

1. Switch to Shopify Markets and complete the renewal flow again.
2. Use a temporary workaround in Channable.

If you use the temporary workaround, metafield media images will not be imported.

{% hint style="warning" %}
If you're unsure whether you use these fields, don't change this setting.
{% endhint %}

What to do:

1. Switch to Shopify Markets and renew again:
   * Check whether you switched to Shopify Markets.
   * If not, follow this [guide for switching to Shopify Markets](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/shopify/guide-for-switching-to-shopify-markets). If you uninstalled the **Channable** app, [reinstall it first](#i-uninstalled-the-channable-app-from-shopify).
   * Complete the renewal flow again, even if it failed before.
2. Or use the temporary workaround:
   * Go to [**Advanced settings**](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/shopify#set-your-advanced-settings-optional) > **Import filter**.
   * Enable `Exclude metafield media images` if you are not using metafield media image fields, or if those fields can stay empty.
   * Run the import again.
3. If you rely on metafield media image fields, leave this setting disabled and contact <support@channable.com>.

</details>

<details>

<summary>Error message (in Shopify): "This app is not listed in the Shopify App Store. Contact the app developer for support. Learn more about unlisted apps."</summary>

<figure><img src="/files/mdGqt0kRaorOskks3fRZ" alt=""><figcaption></figcaption></figure>

We are aware that this message is currently displayed in the Shopify app store.

You do not need to contact us just because you see this message.

If the **Channable** app is still installed, you can keep using it for the renewal flow on this page.

If you already uninstalled it, you can still [reinstall it using the method below](#i-uninstalled-the-channable-app-from-shopify).

We are working with Shopify to get re-listed.

</details>

#### Other issues

<details>

<summary>I uninstalled the Channable app from Shopify</summary>

If the **Channable** app was previously installed in this Shopify store, you can still reinstall it.

This works even though the app is not currently listed in Shopify’s app marketplace.

To reinstall it:

1. Log into your Shopify admin account by going to <https://admin.shopify.com>.
2. Go to **Settings > Apps**.
3. Click the **Uninstalled** tab.
4. Find the **Channable** app.
5. Click **Install**.
6. Follow the on-screen steps to complete the reinstallation.

After reinstalling the app, jump to [Check the import status](#check-the-import-status).

You do not need to repeat the earlier renewal steps.

Reinstalling the app already completes the reauthentication part of the flow.

If you need help after reinstalling, contact <support@channable.com>.

</details>

<details>

<summary>I renewed my connection, but I cannot see my orders in Shopify</summary>

Please allow some time for re-sent orders to appear in Shopify after your connection is active again.

Before you wait, make sure you manually re-sent any failed orders.

Orders that failed while the connection was down are not re-sent automatically.

What to check:

1. Confirm that your Shopify connection was renewed successfully.
2. Confirm that you manually re-sent your failed orders.
3. If you already re-sent them, wait a little longer for them to appear in Shopify.

If your orders still do not appear after that, contact <support@channable.com>.

</details>

For live technical updates, follow our [status page](https://www.channablestatus.com/).
{% endupdate %}

{% update date="2026-05-23" tags="important,info" %}

## A Shopify authentication issue is affecting connections

{% hint style="danger" %}

### IMPORTANT

Some Shopify connections are affected by a Shopify authentication issue.

If your connection is affected, your project may show a red failed marker for Shopify imports and stop receiving new imports, orders, returns, or stock updates.

**Unfortunately, a fix hasn't been identified yet.**
{% endhint %}

### What’s happening?

* We've identified a Shopify authentication issue, that might have an impact on order flows, and could lead to delayed shipments.
* We are working to identify a solution. You can [follow the issue on the status page](https://www.channablestatus.com/).

We'll keep this changelog updated once a fix has been identified, as you may need to take action.
{% endupdate %}

{% update date="2026-05-12" tags="important,info" %}

## Performance data risk for Shopify Google & YouTube app users

If your Shopify store uses the **Google & YouTube app** to send products to Google Merchant Center, you may be affected by a change that **permanently disconnects your historical performance data** (for example, clicks and conversions in Google Ads).

### Who is affected?

<table data-header-hidden><thead><tr><th align="center" valign="top"></th><th align="center" valign="top"></th><th align="center" valign="top"></th></tr></thead><tbody><tr><td align="center" valign="top"><p><i class="fa-circle-exclamation" style="color:$warning;">:circle-exclamation:</i></p><p><strong>Affected</strong></p></td><td align="center" valign="top"><p><i class="fa-triangle-exclamation" style="color:$danger;">:triangle-exclamation:</i></p><p><strong>Most affected</strong></p></td><td align="center" valign="top"><p><i class="fa-circle-xmark" style="color:$primary;">:circle-xmark:</i></p><p><strong>Not affected</strong></p></td></tr><tr><td align="center" valign="top">Shopify merchants who use the Google &#x26; YouTube app as a product source in Google Merchant Center</td><td align="center" valign="top">Merchants who rely on product-level data in Google Ads or Merchant Center (such as Producthero users who use performance-based campaign segmentation and Products AI optimization)</td><td align="center" valign="top">Shopify merchants who <strong>don't</strong> use the Google &#x26; YouTube app</td></tr></tbody></table>

### What happened?

Google is transitioning from the Content API to the Merchant API and will[ remove Content API support starting August 18, 2026](https://support.google.com/merchants/answer/16493611?hl=en). However, Shopify has already started migrating merchants to the Merchant API [(either automatically or via a voluntary app update)](#how-to-check-if-you-were-impacted).

For all stores using the Shopify app as their primary data source in Merchant Center, this migration changes the product IDs Shopify sends to Google Merchant Center. When an item’s ID changes, Google treats it as a new product - [removing any historical performance and conversion data for that item](https://support.google.com/merchants/answer/6324405?hl=en#minimum_requirements:~:text=Use%20a%20stable,and%20its%20history.). Once removed, this is not recoverable.

### What does this mean for me? <mark style="color:$info;">(affected users only)</mark>

If you update to the new version of the Google & YouTube app (or are migrated automatically), you will:

* **Permanently lose historical product performance data** (clicks, conversions) in Google Ads for affected items
* See **campaign learning resets** (Smart Shopping / Performance Max), which can temporarily reduce sales and increase costs

### How to check if you were impacted

If you were automatically migrated, the ID structure of your items will have changed.

You can verify this by reviewing your product IDs and your data source.

1. In [Google Merchant Center](https://merchants.google.com/), go to **Products & store > Products**.
2. In the **All products** tab, you can find a list of your items and their IDs.
3. In the **Product ID** column, compare a few item IDs to see whether the format changed. For example, from `shopify_NL_123456…` to `shopify_ZZ_123456…`
4. Go to **Settings > Data sources > Primary data sources**.
5. Find the data source created by Shopify. In the **Source** column, check whether the source name shows **Merchant API** or **Content API**.
6. Check whether the older Content API source is inactive.
7. Review your findings:

| **Your performance data is at risk if…**                                                                                                                                                                                    | **Your performance data is permanently lost if…**                                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <ul><li>​The Shopify source is still Content API</li><li>​Your item IDs are the same format</li><li>​(if optimized) Product titles haven’t been changed</li><li>​Supplemental data is still applied to your items</li></ul> | <ul><li>​The Shopify source changed to Merchant API or Shopify App API</li><li>​Your item IDs changed format</li><li>​Product titles reverted to Shopify values</li><li>​Supplemental data no longer applies</li></ul> |

### What you can do

<details>

<summary><strong>My performance data was lost</strong></summary>

Unfortunately, if your account was migrated or updated already, there is no way to restore your performance data.

If you use Producthero, you can contact with our support team to see if we can recover your Labelizer labels and title optimizations, but we can’t restore any historical performance data.<br>

</details>

<details>

<summary><strong>My performance data is at risk</strong></summary>

Shopify’s migration directly changes data in Google Merchant Center, which removes historical data and likely impacts ad performance. You can prevent this by sending your product data to Google through a feed management tool instead of directly via Shopify.

With a [Channable core standard plan](https://www.channable.com/pricing), when you create a Google Shopping channel in Channable, you can apply a dedicated rule that safeguards your performance data when your account is migrated.

This helps you:

* Preserve Shopify product IDs before data is sent to Google Merchant Center
* Reconnect supplemental sources and feed labels to the new primary source
* Prevent the Shopify Google & YouTube app from overwriting optimized data

If you are a Producthero customer with campaigns you want to protect, Producthero accounts will be migrated to Channable in 2026, so you can manage both your CSS and product feed conveniently in the same place. Setting up a Google Shopping channel now will save you work later.

{% hint style="info" %}
**Note:** Creating a channel requires a Core standard plan (an additional cost to Channable CSS).
{% endhint %}

For the full step-by-step setup, see [***How to safeguard your performance data from Shopify x Google & YouTube app changes***.](/css/readme/how-to-safeguard-your-performance-data-from-shopify-x-google-and-youtube-app-changes.md)

</details>
{% endupdate %}

{% update date="2026-05-05" tags="new" %}

## Akeneo importer now supports built-in image imports

### What’s new?

The **Akeneo** importer now supports built-in product image imports.

Previously, importing product media from Akeneo into Channable required the **TwicPics** plugin. Akeneo API updates now allow direct media access, which removes that extra dependency for supported setups.

#### Akeneo built-in image imports include:

* **Built-in media access:** Channable can import product images directly from Akeneo when image URLs come from the Akeneo CDN.
* **No Channable changes needed:** Whether built-in imports or **TwicPics** is used depends entirely on your Akeneo setup.
* **TwicPics still supported:** You can keep your current **TwicPics** setup if you prefer it.

{% hint style="info" %}
To enable built-in image imports in Akeneo, go to **Assets > Edit Family > Properties** and turn on **Share links** for the relevant asset family. The images must belong to that asset family. Once enabled, Channable detects the image URLs and imports them as a list of URLs.
{% endhint %}

Learn more about how to use [Akeneo import](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/akeneo).
{% 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/2026/may.md?ask=<question>
```

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.
