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


memo-circle-check 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 exemptionarrow-up-right from Amazon.

  • An Amazon account

Good to know

1

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 grouparrow-up-right or leave this empty.

  4. Click Continue.

2

Categorize your products

  1. In [your Amazon channel], go to the Categories step.

  2. Map (assign) categories for all items.

You can use AI categorizationarrow-up-right to automatically match items to Amazon categories, generate categories from a category fieldarrow-up-right, or create categories manually.

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

3

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 Channablearrow-up-right to transform and optimize your data. See Create rulesarrow-up-right for more information.

4

Map shared attributes

  1. In [your Amazon channel], go to the Build step and click the Shared attributes tab.

  2. Skip Merchant Suggested ASIN.

circle-check
  1. 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.

circle-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

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

circle-info

Note

  • The Repricer only reprices the Standard offer.

  • You need to be enrolled in the Amazon Business program to set Business price

  1. Click Save.

5

Map category attributes

Category attributes are specific fields attributed to items belonging to certain categories.

circle-exclamation

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

chevron-rightI ship my products myself (MFN - Merchant Fulfilled Network)hashtag
circle-exclamation
  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 IDarrow-up-right if used.

  5. Map any remaining mandatory fields to corresponding fields from your dataarrow-up-right.

    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 errorsarrow-up-right.

circle-check
chevron-rightAmazon ships my products (AFN / FBA)hashtag
circle-exclamation
  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 fieldsarrow-up-right.

  4. Repeat for each category.

  5. Go to Quality and resolve any flagged errorsarrow-up-right.

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

circle-check
6

(EU Only) Fulfill GPSR and DSA requirements

The EU introduced new GPSR and DSA requirementsarrow-up-right 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 centerarrow-up-right.

  2. Add project fields to populate the Manufacturer's email and Responsible person’s email or Electronic address attributes.

chevron-rightI don't have project fields for my Manufacturer's email and/or responsible person's email.hashtag

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.

circle-check

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]

  1. Click Save rule.

  2. 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]

  1. Click Save rule.

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

7

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.

8

Test your channel 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.

circle-check
9

Activate your channel

circle-exclamation
  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.

10

Review and fix listing errors

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.

Error types explained

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

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 guidearrow-up-right.

chevron-rightSubmission errors (important)hashtag

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

circle-exclamation
chevron-rightListing errorshashtag

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.

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

chevron-rightWarningshashtag

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

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

Last updated

Was this helpful?