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

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

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 Channable to transform and optimize your data. See Create rules 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.

  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.

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.

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.

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

I ship my products myself (MFN - Merchant Fulfilled Network)
  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 if used.

  5. Map any remaining mandatory fields to corresponding fields from your data.

    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.

Amazon ships my products (AFN / FBA)
  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.

  4. Repeat for each category.

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

6

(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:

  1. Check GPSR and DSA requirements are added to your Amazon Seller account. For more information, visit Amazon's help center.

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

  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.

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.

9

Activate your channel

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

Submission errors (important)

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

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?