# How to use Catalog Matching for Amazon

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 %}

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> 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 %}

<details>

<summary><strong>Example Master rule:</strong></summary>

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.

<div align="center"><img src="/files/z0oJUrSb1rBFf8ANgp8I" alt="Master rule example: EAN to ean"></div>

<div align="center"><img src="/files/UPCtbjWFBGLZkPD6HhtA" alt=""></div>

<div align="center"><img src="/files/BmiJ6DpM5gEE9zY2Mny4" alt=""></div>

</details>

* **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. For **Exclude unmatched items**, enable this if you only want to send items we could match with an ASIN.
   1. **Toggle on:** Only items with an ASIN are included
   2. **Toggle off:** All items will be included
6. Click **Save**.
   {% endstep %}

{% step %}

### Review matches

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

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.

<details>

<summary>Master r<strong>ule example:</strong></summary>

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

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 >** <i class="fa-gear-complex">:gear-complex:</i> **Category**.
6. after 'and', select `set to value` . In the text box that appears, write 'PRODUCT' in all caps.
7. Click **Save rule**.

</details>
{% 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.

<details>

<summary><strong>I see 8541 OR 13013 errors</strong></summary>

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

</details>

{% hint style="success" %}
**Tip:** You can test your setup as many times as needed.
{% endhint %}
{% endstep %}

{% step %}

### Handle unmatched items

If some items didn't have an ASIN match, we can exclude them from your channel and set up a new **List and sell new items** channel with them.

To list these:

1. In the channel you just set up, go to the **Catalog matching** step and click on the **No match** tab.
2. Click **Download as CSV**.
3. Create a new Amazon channel with the listing requirement level **List and sell new items**.
4. Import your items into your channel.
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions: 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/list-advertise/amazon/list-items-on-amazon/how-to-use-catalog-matching-for-amazon.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.
