You are viewing documentation for Amazon Sales Channel 2.x / 3.x.
Refer to Amazon Sales Channel 4.0+ for updated documentation.
After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Creating Attributes for Amazon

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

Prior to onboarding your Amazon Seller Central accounts, we recommend adding Magento product attributes to map your product listings. After you complete onboarding, you can manage your product attributes through the Managing Attributes tab of the Amazon Sales Channel Home.

These instructions detail how to create Magento attributes for Amazon ASIN and Amazon Condition. We recommend creating additional attributes including Amazon EAN, Amazon ISBN, and Amazon UPC. You may want to also create an Amazon Price attribute if you want to use your Amazon listing price as a price source for pricing rules. These attributes are used when configuring your listing and pricing settings during onboarding. They are also be used when creating Amazon listings and when updating and syncing your Magento catalog with your Amazon listings.

Catalog Search settings enable you to set matching search parameters that help to map eligible Magento products with Amazon listings. Once mapped, Amazon activates actions related to pricing, quantity, overrides, and order and product synchronization.

Defining these values increases the potential for exact matches, minimizing the need for manually matching product listings later. Adding the attributes as part of your onboarding Pre-Setup Tasks, Amazon Sales Channel has a higher potential for automatically matching your products during onboarding and syncs product data between Amazon and Magento after onboarding.

If you only create the Amazon ASIN attribute (without adding ASIN values per product), your Magento products may not automatically your Amazon listings will automatically. You can manually match your products through Store Review. However, manual matching does not create the data elements needed to share and sync your product data.

Important: If you manually matched a product and you need to update an ASIN, UPC, or other data element for the product, you would have to update the data in both places, in your Magento catalog and in your Amazon listing in your Amazon Seller Central account.

To create the Amazon ASIN product attribute:

  1. Log into your Magento Admin.

  2. Click Stores in the left-side menu. In the Attributes section, click Product.

  3. Click Add New Attribute to display the Attributes Properties screen.

  4. For Default Label, enter “Amazon ASIN” (the name for your attribute).

  5. For Catalog Input Type for Store Owner, choose Text Field.

  6. From the Values Required drop-down, choose No.

    Although an Amazon ASIN is required to list a product on Amazon, some of your catalog products may not be listed on Amazon.

  7. Expand the Advanced Attribute Properties section.

  8. For Attribute Code, enter “amazon_asin”.

  9. For Scope, choose Global.

  10. For Unique Value, choose No.

  11. For Input Validation for Store Owner, choose None.

  12. For Add to Column Options, choose Yes.

  13. For Use in Filter Options, choose Yes.

  14. Click Save Attribute.

Amazon ASIN Attribute

To create the Amazon Condition product attribute:

  1. Log into your Magento Admin.

  2. Click Stores in the left-side menu. In the Attributes section, click Product.

  3. Click Add New Attribute to display the Attributes Properties screen.

  4. For Default Label, enter Amazon Condition (the name for your attribute).

  5. For Catalog Input Type for Store Owner, choose Dropdown.

    The Manage Options (Values of your Attribute) section will display.

  6. For Values Required, choose No.

  7. For Manage Options (Values for your Attribute), add each of your condition options.

    Standard Amazon conditions include:

    • New: Refurbished: Used
    • Like New: Used
    • Very Good: Used
    • Good: Used
    • Acceptable: Collectible
    • Like New; Collectible
    • Very Good: Collectible
    • Good: Collectible; Acceptable
  8. Click Add Option.

  9. Click to check the Is Default option for the option you wish to be the default selection.

  10. In the Admin column, enter the text for the label of the condition you are adding (New, Used, Used-Like New, etc.)

  11. Click Add Option to add more drop-down options, as needed.

  12. Expand Advanced Attribute Properties section.

  13. For Attribute Code, enter “amazon_condition”.

  14. For Scope, choose Global.

  15. For Unique Value, choose No.

  16. For Input Validation for Store Owner, choose None.

  17. For Add to Column Options, choose Yes.

  18. For Use in Filter Options, choose Yes.

  19. Click Save Attribute.

Amazon Condition Attribute