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.
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 from Amazon.
An Amazon account
Good to know
If an item is part of a brand enrolled in Amazon Brand Registry, you need to be a Brand Representative or Authorized reseller list it
Create your Amazon channel
In Channable, go to Projects > [Your project] > Channels.
Click + Create Channel and select Amazon.
Fill in your channel settings:
Name: Choose a name for your channel. This is for your reference only.
Unique ID per item: Select the field containing your product IDs (often
id).Amazon Country: Select the country (Amazon Marketplace) you want to advertise your listings in.
Listing requirement level: Select Offer and product.
Amazon error language: Select your preferred error language.
Use master rule group (optional): Add a master rule group or leave this empty.
Click Continue.
Categorize your products
In [your Amazon channel], go to the Categories step.
Map (assign) categories for all items.
You can use AI categorization to automatically match items to Amazon categories, generate categories from a category field, or create categories manually.
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.
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 to transform and optimize your data. See Create rules for more information.
Map shared attributes
In [your Amazon channel], go to the Build step and click the Shared attributes tab.
Skip Merchant Suggested ASIN.
Tip: If some of your products have ASINs, we recommend excluding them and setting up a separate offers only channel for those items.
For External product ID, click + Add and map:
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).
ID: map the corresponding field in your import that contains the product ID.
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
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.
Note
The Repricer only reprices the Standard offer.
You need to be enrolled in the Amazon Business program to set Business price
Click Save.
Map category attributes
Category attributes are specific fields attributed to items belonging to certain categories.
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.
We recommend mapping at least the following attributes:
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.
For specific instructions, select your fulfillment use case (MFN / AFN/FBA):
I ship my products myself (MFN - Merchant Fulfilled Network)
Important: If using the repricer (add-on), 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.
In Build, click Attributes per category.
Select a category and scroll to the Offer section.
Next to Fulfillment availability, click + Add:
For Fulfillment channel code: Static values >
DEFAULTFor Quantity: select your stock field
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.
For Merchant Shipping Group: map your shipping template ID if used.
Map any remaining mandatory fields to corresponding fields from your data.
If selling on Amazon US and Item Type Keyword appears in “Information to uniquely identify your product”, choose Internal fields >
recommended_browse_nodes.
Repeat for each category.
Go to the Quality step and resolve any flagged errors.
Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.
Amazon ships my products (AFN / FBA)
Important: If using the repricer (add-on), 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.
In Build, click Attributes per category.
In the Offer section, next to Fulfillment availability, click + Add:
Set Fulfillment channel code to the Amazon warehouse code (Static values >
[your relevant Amazon code]).If selling on Amazon US and Item Type Keyword appears, set Internal fields >
recommended_browse_nodes.
Map any remaining mandatory fields.
Repeat for each category.
Go to Quality and resolve any flagged errors.
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.
Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.
(EU Only) Fulfill GPSR and DSA requirements
The EU introduced new GPSR and DSA requirements for selling within the EU. To ensure compliance on Amazon:
Check GPSR and DSA requirements are added to your Amazon Seller account. For more information, visit Amazon's help center.
Add project fields to populate the Manufacturer's email and Responsible person’s email or Electronic address attributes.
I don't have project fields for my Manufacturer's email and/or responsible person's email.
If you haven't imported these yet, follow these steps:
In Channable, go to Setup.
In the Edit column of the import you're using your Amazon, click Edit mapping > Setup project fields.
Click + Add project field and fill in the following information:
Name: dsa_responsible_party_address
Type: Text
Click Save & import.
Click + Add project field and fill in the following information:
Name: gpsr_manufacturer_reference_email_address
Type: Text
Click Save & import.
In [your Amazon channel], go to the Build step.
Click on the Attributes per category tab and select a category.
Scroll to the Safety & Compliance section and map your newly added project fields:
Manufacturer's Email or Electronic Address:
gpsr_manufacturer_reference_email_addressResponsible Person’s email or Electronic Address:
dsa_responsible_party_address
Click Save.
Repeat step 4-6 for any remaining categories.
Tip: Click Auto-map fields to automatically map attributes.
Fill in fields using rules
Go to Rules and create a new rule named “Fill gpsr_manufacturer_reference_email_address”.
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]
Click Save rule.
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]
Click Save rule.
Your new rule will populate the required GPSR/DSA fields for Amazon.
Activate your channel
Important: Amazon processes data more slowly between 12:00–17:00 UTC. Change your schedule settings to run outside this window. Runs that take longer than 2 hours will auto-stop and need to be restarted.
In [your Amazon channel], go to the Settings step.
Click Activate API.
Click Save.
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.
Review and fix listing errors
Amazon enforces strict data requirements. The Feedback tab shows issues (errors and warnings).
Go to the Result step of your Amazon channel and open the Feedback tab for an overview of all possible errors and warnings.
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
In Feedback, start resolving issues, prioritizing submission errors:
Click the red error code in Description to see details.
Note the attribute causing the error (e.g., Item Weight) and click Go to attribute to jump to it.
Re-map the attribute: choose a static value, a project field, or a manual value.
Click Save.
Repeat for any other errors.
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 guide.
Submission errors (important)
Submission errors happen when Amazon encounters issues processing your product data after you send your listings.
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.
Listing errors
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.
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.
Warnings
Warnings indicate an issue occurred that should be reviewed but hasn't prevented the submission from processing.
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?