# Create or manage listings on Amazon

Follow these steps if you want to create new listings and manage existing ones on Amazon via the same channel.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You’ll need**

* Products with identifiers (e.g. GTIN, EAN, UPC, ISBN)
* If you don’t have products with identifiers, you need an approved  [GTIN exemption](https://sellercentral.amazon.com/gp/help/external/G200426310) from Amazon.
* An Amazon account

**Good to know**

* If an item is part of a brand enrolled in [Amazon Brand Registry](https://sell.amazon.com/brand-registry), you need to be a [Brand Representative](https://sell.amazon.com/blog/brand-registry-roles) or[ Authorized reseller](https://sell.amazon.com/blog/brand-registry-roles) list it
* Items from [certain categories require approval from Amazon to list](https://sell.amazon.com/blog/brand-registry-roles).

{% stepper %}
{% step %}

### Create your Amazon channel

1. In Channable, go to **Projects > \[Your project] > Channels**.
2. Click **+ Create Channel** and select **Amazon**.
3. Fill in your channel settings:
   1. **Name:** Choose a name for your channel. This is for your reference only.
   2. **Unique ID per item:** Select the field containing your product IDs (often `id`).
   3. **Amazon Country:** Select the country (Amazon Marketplace) you want to advertise your listings in.
   4. **Listing requirement level:** Select **Offer and product**.
   5. **Amazon error language:** Select your preferred error language.
   6. **Use master rule group (optional):** Add a[ master rule group](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable/create-master-rule-groups) or leave this empty.
4. Click **Continue**.
   {% endstep %}

{% step %}

### Categorize your products

1. In **\[your Amazon channel]**, go to the **Categories** step.
2. Map (assign) categories for all items.

You can use[ AI categorization](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/categorize-products/create-product-categories/ai-product-categorization) to automatically match items to Amazon categories,[ generate categories from a category field](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/categorize-products/create-product-categories/use-the-generate-categories-function), or create categories manually.

{% hint style="info" %}
**Note:** AI Categorization may not categorize all items automatically, or be completely accurate. We recommend reviewing the AI-suggested categories. Any remaining uncategorized items will need to be manually categorized.
{% endhint %}
{% endstep %}

{% step %}

### Create rules to enrich, filter, and refine your product data

When product data is incomplete or doesn’t match Amazon’s required format, use[ rules in Channable](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable) to transform and optimize your data. See[ Create rules](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules) for more information.
{% endstep %}

{% step %}

### Map shared attributes

1. In **\[your Amazon channel]**, go to the **Build** step and click the **Shared attributes** tab.
2. Skip **Merchant Suggested ASIN**.

{% hint style="success" %}
**Tip:** If some of your products have ASINs, we recommend excluding them and setting up a separate offers only channel for those items.
{% endhint %}

3. For **External product ID**, click **+ Add** and map:
   1. **Type:** from dropdown choose Static value, then pick the ID format used (e.g. ean, gtin, upc) — note this value is case sensitive and must be lowercase (ean, gtin, upc).
   2. **ID:** map the corresponding field in your import that contains the product ID.

{% hint style="info" %}
**Note:** If your import field uses uppercase (EAN/GTIN/UPC), create a rule to convert it to lowercase.

**Example rule:**

**If** `all`

**Then** take `id_type` and `modify text`  `lowercase all words`
{% endhint %}

3. **Purchasable offers (Standard and Business price)**: If you don’t want to send pricing information, ignore these sections.
   * For **Standard**: map attributes under Purchasable offer (Standard) for Offer information and Discount price as needed.
   * For **Business price**: map attributes under Purchasable offer (Business price) and use + Discount to add discount details if needed.

{% hint style="info" %}
**Note**

* The Repricer only reprices the Standard offer.
* You need to be enrolled in the Amazon Business program to set Business price
  {% endhint %}

4. Click **Save**.
   {% endstep %}

{% step %}

### Map category attributes

Category attributes are specific fields attributed to items belonging to certain categories.&#x20;

{% hint style="warning" %}
**Important disclaimer**

Amazon updates its listing requirements often, and there are thousands of product categories. This means we can't tell you exactly which attributes you need to map to successfully list your products.&#x20;

We recommend mapping at least the following attributes:

* &#x20;Quantity (in Fulfilment Availability section)
* Item Condition
* Country of Origin
* Fulfilment availability

To find out what information Amazon requires for your specific products, [download Amazon's inventory template](https://helpcenter.channable.com/hc/en-us/articles/360014280220-How-to-identify-required-attributes-for-your-Amazon-channel).&#x20;
{% endhint %}

For specific instructions, select your fulfillment use case (MFN / AFN/FBA):

<details>

<summary>I ship my products myself (MFN - Merchant Fulfilled Network)</summary>

{% hint style="warning" %}
**Important:** If using the[ repricer (add-on)](https://www.channable.com/products/marketplace-integrator/repricer), set **Fulfillment channel code** to `DEFAULT` and map **Quantity** to your stock. Failing to do so can feed the repricer incorrect data and block repricing.
{% endhint %}

1. In **Build**, click **Attributes per category**.
2. Select a category and scroll to the **Offer** section.
3. Next to **Fulfillment availability**, click **+ Add**:
   1. For **Fulfillment channel code**: **Static values** > `DEFAULT`
   2. For **Quantity**: select your stock field
   3. For **Handling time**: if it takes longer than 2 days to ship, fill in the number of days (e.g., 5). If under 2 days, leave empty.
4. For **Merchant Shipping Group**: map your[ shipping template ID](https://channable-test.gitbook.io/channable-test-docs/list-advertise/amazon/list-items-on-amazon/how-to-configure-shipping-templates-for-amazon) if used.
5. Map any remaining mandatory[ fields to corresponding fields from your data](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step).
   1. If selling on Amazon US and **Item Type Keyword** appears in “Information to uniquely identify your product”, choose **Internal fields** > `recommended_browse_nodes`.
6. Repeat for each category.
7. Go to the **Quality** step and resolve any flagged[ errors](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step).

{% hint style="success" %}
**Tip:** Click **Auto-map fields** to automatically map using information using information from your other channels or other similar setups.[ Learn more](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}

</details>

<details>

<summary>Amazon ships my products (AFN / FBA)</summary>

{% hint style="warning" %}
**Important**: If using the[ repricer (add-on)](https://www.channable.com/products/marketplace-integrator/repricer), set the correct Amazon warehouse code in Fulfillment channel code (e.g., `AMAZON_EU`). Do not map **Quantity**. Failing to do so can block repricing.
{% endhint %}

1. In **Build**, click **Attributes per category**.
2. In the **Offer** section, next to **Fulfillment availability**, click **+ Add**:
   1. Set **Fulfillment channel code** to the Amazon warehouse code (**Static values** > `[your relevant Amazon code]`).
   2. If selling on Amazon US and **Item Type Keyword** appears, set **Internal fields** > `recommended_browse_nodes`.
3. Map any remaining mandatory[ fields](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step).
4. Repeat for each category.
5. Go to **Quality** and resolve any flagged[ errors](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step).

{% hint style="info" %}
**Note:** Some attributes are required by Amazon even if they don’t make sense for your product. In such cases, choose a relevant static value or map the most appropriate import field.
{% endhint %}

{% hint style="success" %}
**Tip**: Click **Auto-map fields** to automatically map using information using information from your other channels or other similar setups.[ Learn more](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}

</details>
{% endstep %}

{% step %}

### (EU Only) Fulfill GPSR and DSA requirements

The EU introduced new[ GPSR and DSA requirements](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/get-started-with-marketplaces/what-you-need-to-do-to-be-gpsr-and-dsa-compliant) for selling within the EU. To ensure compliance on Amazon:

1. Check GPSR and DSA requirements are added to your Amazon Seller account. For more information, visit[ Amazon's help center](https://sellercentral.amazon.co.uk/help/hub/reference/G8AECGHY2KLD88D7).
2. Add project fields to populate the Manufacturer's email and Responsible person’s email or Electronic address attributes.

<details>

<summary>I don't have project fields for my Manufacturer's email and/or responsible person's email.</summary>

If you haven't imported these yet, follow these steps:

1. In Channable, go to **Setup**.
2. In the **Edit** column of the import you're using your Amazon, click **Edit mapping  > Setup project fields**.
3. Click **+ Add project field** and fill in the following information:
   1. **Name**: dsa\_responsible\_party\_address
   2. **Type**: Text
4. Click **Save & import**.
5. Click **+ Add project field** and fill in the following information:
   1. **Name**: gpsr\_manufacturer\_reference\_email\_address
   2. **Type**: Text
6. Click **Save & import**.
7. In **\[your Amazon channel]**, go to the **Build** step.
8. Click on the **Attributes per category** tab and select a category.
9. Scroll to the **Safety & Compliance** section and map your newly added project fields:
   1. **Manufacturer's Email or Electronic Address**: `gpsr_manufacturer_reference_email_address`
   2. **Responsible Person’s email or Electronic Address**: `dsa_responsible_party_address`
10. Click **Save**.
11. Repeat step 4-6 for any remaining categories.

{% hint style="success" %}
Tip: Click **Auto-map fields** to automatically map attributes.
{% endhint %}

#### **Fill in fields using rules**

1. Go to **Rules** and create a new rule named “Fill gpsr\_manufacturer\_reference\_email\_address”.
2. Create the following rule:

**If** `all`

**Then** take `gpsr_manufacturer_reference_email_address` and `search for value` in `brand`

Search for value in (part of) field

Use replacement value

1

\[use brand name here]

\[manufacturer’s email]

2

\[use brand name here]

\[manufacturer’s email]

3. Click **Save rule**.
4. Click + to create another rule. Name it “Fill dsa\_responsible\_party\_address”.

* Create the following rule:

**If** all

**Then**  take `dsa_responsible_party_address` and `set to value` \[YOUR EMAIL ADDRESS]  &#x20;

5. Click **Save rule**.

Your new rule will populate the required GPSR/DSA fields for Amazon.

</details>
{% endstep %}

{% step %}

### Connect to Amazon

1. Return to **Settings**.
2. For **Linked seller account**, click **Select seller account**.
3. Select an existing Amazon connection, or create a new one.
4. Click **Connect with Amazon**. You’ll be redirected to your Amazon Seller account to finalize the connection.
   {% endstep %}

{% step %}

### Test your channel setup&#xD;

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**.&#x20;

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

{% step %}

### Activate your channel

{% hint style="warning" %}
Important: Amazon processes data more slowly between 12:00–17:00 UTC. Change your[ schedule settings](https://channable-test.gitbook.io/channable-test-docs/get-started/getting-started/create-a-new-project/project-settings) to run outside this window. Runs that take longer than 2 hours will auto-stop and need to be restarted.
{% endhint %}

1. In **\[your Amazon channel]**, go to the **Settings** step.
2. Click **Activate API**.
3. Click **Save**.
4. Click **Run now** to send product listings to Amazon.

Your channel will start creating/adding new listings and/or offers to Amazon. How long this takes depends on the amount of product data sent.
{% endstep %}

{% step %}

### &#x20;Review and fix listing errors&#xD;

Amazon enforces strict data requirements. The Feedback tab shows issues (errors and warnings).

1. Go to the **Result** step of your Amazon channel and open the Feedback tab for an overview of all possible errors and warnings.
2. Return to the **Overview** tab to view product listing statuses and filter by:
   * **Active listings**: successfully listed
   * **Inactive listings**: listed but inactive
   * **Incomplete listings**: missing required info
   * **No match found**: not in Amazon’s catalog
3. In **Feedback**, start resolving issues, prioritizing submission errors:
   1. Click the red error code in **Description** to see details.
   2. Note the attribute causing the error (e.g., Item Weight) and click Go to attribute to jump to it.
   3. Re-map the attribute: choose a static value, a project field, or a manual value.
   4. Click **Save**.
4. Repeat for any other errors.
5. Click **Run now** to resend your products to Amazon.
   {% endstep %}
   {% endstepper %}

### Error types explained

Errors indicate an issue occurred which prevented the submission from processing. (e.g. a validation error.)&#x20;

We detail all the possible error types you can encounter below. For information on how to solve a specific error, refer to our [Amazon error troubleshooting guide](https://channable-test.gitbook.io/channable-test-docs/list-advertise/amazon/list-items-on-amazon/how-to-solve-common-amazon-errors).

<details>

<summary><strong>Submission errors (important)</strong></summary>

Submission errors happen when Amazon encounters issues processing your product data after you send your listings.

{% hint style="warning" %}
**Important:** If one of your products has a submission error, it can have a cascading effect and prevent other products from processing. Because of this, prioritize fixing submission errors before addressing other errors.
{% endhint %}

</details>

<details>

<summary><strong>Listing errors</strong></summary>

Listing state errors are additional errors we request from Amazon to make sure you have all the information you need to go live and optimize your listing. Because we pull all possible errors, some listing state errors aren’t relevant to and can't be resolved within Channable.

{% hint style="info" %}
**Note:** If you notice a product with a listing error is updating as it should on Amazon, you can ignore the error, but fixing listing state errors can improve your listing quality.
{% endhint %}

</details>

<details>

<summary><strong>Warnings</strong></summary>

Warnings indicate an issue occurred that should be reviewed but hasn't prevented the submission from processing.

</details>

{% hint style="info" %}
**Note**

* Dry runs clear submission errors (useful for testing) but only normal runs keep full feedback history.
* Some listing state errors stem from older Amazon API versions (V1) and cannot be resolved via standard API use on V2. Amazon is working on fixes.

If you encounter this, try deleting listings with the error by removing their SKUs from your channel. Wait 24 hours, then resubmit the listing.
{% endhint %}


---

# 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-set-up-an-amazon-channel/create-or-manage-listings-on-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.