> 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/october/improved-alternative-id-mapping.md).

# Improved alternative ID mapping

October 19, 2026

We've improved alternative ID mapping so Channable can match more marketplace orders to the right product in your eCommerce platform.&#x20;

> **You need the order-sync add-on**
>
> Alternative ID mapping works with [order connections](https://helpcenter.channable.com/list-advertise/orders/order-connections.md).&#x20;

<details>

<summary><strong>What is this for?</strong></summary>

Marketplaces don't always send the product ID your eCommerce platform uses. For example, a marketplace might send an EAN while your platform uses an SKU. When Channable can't find a matching product, the order fails.

With a Channable order connection and alternative ID mapping enabled, the marketplace identifier can be mapped back to your platform's unique product ID, so the order is created in your eCommerce platform.

</details>

#### What's new

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Two mapping methods</strong></td><td><p>Map orders by alternative channel ID if you list through a channel in Channable, or by alternative import ID if you only use an order connection. </p><p></p><p>If both are on, Channable tries the channel ID first.</p></td></tr><tr><td><strong>Alternative IDs only need to exist in Channable</strong></td><td>With channel ID mapping, you can add marketplace IDs with rules or a secondary import, without changing your eCommerce platform.</td></tr><tr><td><strong>See which items match</strong></td><td>The Alternative ID mapping tab now shows the IDs Channable tracks for each item, and flags items with no match or multiple matches.</td></tr></tbody></table>

#### Do I need to change anything?

No. Your existing alternative ID mapping keeps working.

To use the channel ID method, go to **Channels > \[your channel] > Settings > Order connection > Alternative ID mapping** and turn on **Map orders by alternative channel ID**.

### Learn more

{% content-ref url="/spaces/F8GepmoSonQRG6RnHOxJ/pages/k04mjwrkaONiivyAqhAn" %}
[Match orders with alternative IDs](https://helpcenter.channable.com/list-advertise/orders/configure-order-setup/alternative-product-ids.md)
{% endcontent-ref %}

{% content-ref url="/spaces/F8GepmoSonQRG6RnHOxJ/pages/c899cc5737dbdaac7be2397f9196e1376002bd46" %}
[Set up alternative ID mapping](https://helpcenter.channable.com/list-advertise/orders/configure-order-setup/alternative-product-ids/using-alternative-product-ids-in-orders.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/changelog/2026/october/improved-alternative-id-mapping.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
