> 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/list-advertise/amazon/list-items-on-amazon/how-to-use-catalog-matching-for-amazon.md).
# How to use Catalog Matching for Amazon
Learn how to use Catalog Matching in your Amazon channel to match products to existing ASINs, review results, and handle unmatched items.
In this guide, we explain how to use the Catalog Matching feature in your Amazon channel to match your items to ASINs on Amazon.
{% hint style="info" %}
Important: If enabling this feature on an existing channel (API), make sure to remove all categories before starting.
{% endhint %}
***
### :memo-circle-check: Before you start
**You’ll need**
* An Amazon channel in Channable
* No items categorized in the **Categories** step (if using Catalog Matching in an existing Amazon channel)
**Good to know**
* You don’t need to activate your channel or link a seller account to use the catalog matching feature, however, this can improve the amount of matched items. You will also need to link it to receive information back from Amazon and publish your listings.
* If you're missing required fields in the first step, you can fill them in by creating a new [master rule group](/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable/create-master-rule-groups.md) and adding rules to it.
{% stepper %}
{% step %}
### Enable catalog matching
1. Go to the **Settings** step in **\[your Amazon channel]**.
2. Set the **Listing requirement level** to **Add offers to existing Amazon listings**.
3. At **Catalog item matching**, click the toggle to enable it. Additional fields will appear.
4. Fill in the required fields:
* **External ID number**: Select the field that contains your product identifiers (e.g. `EAN`, `GTIN`, or `UPC` **numbers**).
* **External ID type**: Select the field containing the product identifier types you’re using (e.g. `EAN`, `GTIN`, or `UPC`)
{% hint style="warning" %}
**Important:** make sure the External ID types use **lowercase letters** (like `gtin` instead of `GTIN`)
{% endhint %}
{% hint style="info" %}
**Note:** If you don’t have a field containing your ID types, add a new one and fill it using a [master rule](/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable/create-master-rule-groups.md).
{% endhint %}
Example Master rule
1. In the sidebar, go to **Master rules**.
2. Create a new rule group and give it a descriptive name (like 'Amazon catalog matching').
3. Click **Continue**. You will be directed to a Rules page.
4. Click **Create rule**.
5. Give your rule a descriptive name (e.g. 'Categorization - PRODUCT')
6. Click **Create**.
7. Create a rule to sort your items:
\----
*Example rule: assign EANs*
1. **If** `id` `length exceeds` `"[FILL LENGTH HERE]"`
2. Hover over the **If** part and click **+ > And**.
3. For **And**, fill in `id` `length doesn't exceed` `"FILL LENGTH HERE"` .
4. For **Then**, map `[field containing ID type information]` and `set to value` `"ean"`.
\----
8. Click **Save rule**.
9. Repeat and create new rules for any remaining ID types.
* **ASIN project field**: Choose a project field to store ASIN information in.
* **If field is empty**: Channable will fetch ASINs from Amazon and fill the field with those values.
* **If field contains values**: Your ASINs will be used first, and we’ll fill in the rest.
{% hint style="info" %}
**Note:** If you don’t have an empty project field to use to store your ASINs, you can [add a new one](https://helpcenter.channable.com/get-started/getting-started/fields-in-channable/map-and-add-fields#open-add-project-field).
{% endhint %}
5. Use **Exclude unmatched items** to control which items are sent to Amazon.
1. **Toggle on:** Only items with an ASIN are included.
2. **Toggle off:** All items are included.
3. You can review matched and unmatched items in **Catalog matching** either way.
6. Click **Save**.
{% endstep %}
{% step %}
### Review matches
In the **Catalog matching step,** you'll see an overview of which of your item IDs we could match to ASINs.
**How to review:**
1. Items are separated into three possible groups:
1. **Matched:** A 1:1 match found on Amazon.
2. **Multiple matches:** Several possible matches found.
3. **No match:** These items don't exist in Amazon catalog.
{% hint style="info" %}
**Note:** We cover how to exclude items without matches from your channel setup in [Step 7](#handle-unmatched-items).
{% endhint %}
2. In the **Amazon product title** column, click on the links to view the matched Amazon listing page.
3. In the **Source** column, you can see whether the match was set using our system (`Channable`) or from values you provided in the ASIN project field you selected in the previous step (`User`)
{% endstep %}
{% step %}
### Review and adjust categories
You can skip this step if your items are all already placed in the PRODUCT category.
If your items have different categories, you'll need to remove any pre-categorized items and create a master rule to ensure all items fall under the same `PRODUCT` category.
Example master rule
1. Go to **Master rules** step. In the rule group you created in Step 1, click **Rule >** **Create rule**.
2. Give your rule a descriptive name (e.g. 'Categorization - PRODUCT')
3. Click **Create**.
4. Leave the condition (IF) as **If** `all`
5. For the action (Then), click the dropdown after 'take' and select **Internal fields >** :gear-complex: **Category**.
6. after 'and', select `set to value` . In the text box that appears, write 'PRODUCT' in all caps.
7. Click **Save rule**.
{% endstep %}
{% step %}
### Map shared attributes
1. Go to the **Build** step and click the **Shared attributes** tab.
2. Map any remaining fields marked **Required by marketplace**.
These remaining fields should be related to:
* Price
* Condition (e.g. new, used)
* Compliance
* Stock
* Shipping promise
3. Check and map any remaining fields mapped as Recommended to see if they apply to your setup.
4. Click **Save**.
{% endstep %}
{% step %}
### Map category attributes
1. Go to the **Attributes per category** tab in the Build step. You should see one category: PRODUCT.
2. Click on PRODUCT.
3. Review all fields and map attributes relevant to your items to a value or project field.
4. Click **Save.**
{% endstep %}
{% step %}
### Test your setup
Testing your channel setup helps you check your channel setup and listings with Amazon before you publish them.
To test your setup, click **Test channel setup**.
You can review your feedback in the **Feedback** tab in the **Results** step.
I see 8541 OR 13013 errors
Check the whether your channel meets the right conditions:
* You only have one category - `PRODUCT` . You can check this in the **Attributes per category** tab in the **Build** step.
* The **Quantity** attribute has a relevant field or value mapped to it.
* The **Condition** attribute has a relevant field or value mapped to it.
If your channel meets the above conditions persist after 48 hours, there may be listing restrictions on the ASIN. If you aren't sure, [contact our Support team](/get-started/contact-support.md).
{% hint style="success" %}
**Tip:** You can test your setup as many times as needed.
{% endhint %}
{% endstep %}
{% endstepper %}
### Handle unmatched items
Use this workflow when you manage a brand catalog with unknown Amazon coverage and need separate channels for existing and new listings.
{% hint style="success" %}
Enable **Exclude unmatched items** in your Offer-only channel. This sends only items matched to Amazon listings, and simplifies your setup.
{% endhint %}
{% hint style="info" %}
The **Catalog matching** step shows matched and unmatched items whether **Exclude unmatched items** is enabled or disabled. Download the **No match** results to create a separate channel for unmatched items.
{% endhint %}
{% stepper %}
{% step %}
### Export unmatched items
1. In your Amazon channel, go to **Catalog matching**.
2. Click the **No match** tab.
3. Click **Download as CSV**.
4. Open the CSV in Google Sheets.
5. Copy every value in the `unique_id` column.
{% endstep %}
{% step %}
### Route unmatched items to a new channel
1. Create a new Amazon channel.
2. Set **Listing requirement level** to **List and sell new items**.
3. Go to the **Rules** step.
4. Create the following rule:
If `id` `doesn't contain any of`
```
[paste ids here]
```
**Then** take `all` and `exclude`.
5. Click **Save**.
6. Continue [setting up your channel as usual](/list-advertise/amazon/list-items-on-amazon/how-to-set-up-an-amazon-channel/create-or-manage-listings-on-amazon.md).
{% endstep %}
{% endstepper %}
This new channel contains only items without Amazon matches. You can list them as new products.
---
# 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, and the optional `goal` query parameter:
```
GET https://helpcenter.channable.com/list-advertise/amazon/list-items-on-amazon/how-to-use-catalog-matching-for-amazon.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
