To main website
  1. Help Center - Channable
  2. API's
  3. Amazon API

Articles in this section

Configuring a parent/child (or drop-down) structure for Amazon marketplace

This help center article covers Amazon's feature for displaying product variants in a drop-down menu, streamlining customer navigation and listing organization. We'll guide you how you can set this up in Channable.

Would you like to learn interactively about all the basics related to creating an API export, or how to set up an advanced API in Channable? Start by creating a Channacademy account in the Channable app by following the instructions provided in this help center article. Once you have created an account, you can choose to get started with either the Basic APIs course or the Expert APIs course.

Note: In Channable, we refer to product identifiers as 'IDs' and 'Item_group_ids', which correspond to 'SKU' and 'Parent SKU' in Amazon's terminology. 

How do I set up a parent/child structure?

In order to display your product variants on Amazon and in your Amazon inventory using a drop-down window, you will need to create two separate Amazon APIs for each country. One API will be for the parent products and the other will be for the variants. The guide below will assist you in configuring these two APIs in Channable.

Important: If you have both products with variants and single/individual products, you need to set a third API for this. You need to exclude all of your single/individual product IDs from both the Parent API and the Child API. Then, add a separate API (e.g., called Amazon Single Products). In this third API, you need to include only the IDs of your single products. Set this third API by following this guide.

 

The table below illustrates how Amazon requires the information to be structured in their fields for a Parent product and its Child products, also known as variants. This table will serve as a reference guide to demonstrate how to configure the APIs in Channable in order to provide Amazon with the necessary information.

Amazon_parent-variant_-_EN_1.png

Note: also see Amazon's article on parent-child relationships.

1. Amazon Parent API setup

The ‘Parent’ product is the primary product under which the variations of that product are listed. The Parent product itself does not have any product-specific offer information, nor does it need any of the content from the attributes (see the reference table above). In short, what does need to be configured for Parent products in the Amazon Parent API is:

  • A title
  • An item group ID
  • A Parentage
  • A Variation Theme

In the Parent API, you need to configure a parent product for each product you have variants for. Add a new API for the Parents and configure the following:

  1. When adding a new API for the Amazon Parent API, in the Settings, you need to select your parent ID field as the ‘Unique ID per product’. This field is often called ‘item_group_id’ or ‘parent_id’. On Amazon, it will function as the SKU for the parent, as you can see in the reference table above.
    Amazon_parent-variant_-_EN_2.png
    Note: In some instances, for example when importing products from Magento with configurable, this might be a little different. It can be that your parent (or 'Configurable' as it is called in Magento) product is imported without item_group_id. The normal 'ID' of the configurable is then the same as the 'item_group_id' of the simple (or variants). If this is the case for you, you need to use the normal 'ID' throughout the Parent setup. You still need to use the 'item_group_id' field for the Parent SKU in the Variant setup!
  2. Categorization: Categorize the products as usual (or copy categories from an existing Amazon API). 
  3. Rules: There are a couple of rules that have to be made, for a successful parent/child setup:
    • Group items rule. You can group either on your ‘item_group_id’ field, or on the title (if the title of all your variants is the same, as is the case in the reference table above). After this rule, you should have only 1 ‘Parent’ item per group of variant products.
      image.png
    • Empty certain fields: make a rule to empty the ‘price’, ‘stock’, ‘description’, and ‘GTIN/EAN’ of these parent products. As you can see in the reference table above, these values are not necessary for the Parent product.
      Amazon_parent-variant_-_EN_3.png
      (Optional) You can use a generic title for your Parent products. For example, if you sell a certain type of T-Shirt, you do not want the color or size to be in the title. You only want to display the name of the T-Shirt here. If you want to change the titles of your Parent products, you can use a rule to do so.
  4. Build step: Even though we emptied some fields with a rule, you have to still link these fields in the Build step. This ensures the system works properly, similar to setting up a 'normal' API, where you connect all required fields, even if we're not sending all the data (title being the exception). This step is key to keeping everything running smoothly.
  5. Attributes: In the Attributes, you need to configure the following:
    • ‘Parentage’ needs to be set to ‘Parent’.
    • ‘Variation Theme’ needs to be set to the preferred variation theme (the reference table above uses ‘Size’). Three common variant options are: Color, Size, and SizeColor. For a full list of the possible variation themes, click on the ‘Variation Theme’ attribute in the Attribute builder of your Amazon Parent API.

Amazon_parent-variant_-_EN_4.png

    • You do not need to fill in any other attribute for the Parent products!


2. Amazon Child/Variant API setup

In the Child, or Variant, API, you will configure all the variant products and their product information. Add a new API for the Variants and configure the following:

  1. In the Settings of the new Amazon Variant API, you need to select your ID field as the ‘Unique ID per product’. On Amazon, it will function as the unique SKU for your variants, as you can see in the reference table above.
    Amazon_parent-variant_-_EN_5.png
  2. Categorization: Categorize the products as usual (or copy categories from existing Amazon API).
  3. Rules: Add rules in the Rules step to optimize your items' data according to your preferences.
  4. Build step: Fill the Build step as usual.
  5. Attributes: In the Attributes step, you need to fill all mandatory attributes. Moreover, in the Attributes step, you need to configure the following for the Parent/Variant setup to work (also see the reference table above):
    • Set the ‘Parent SKU’ attribute to the ‘item_group_id’ or ‘parent_id’. Make sure you use the field that has the same value as the SKU for your parents, as can be seen in the reference table (SKU for the Parent API = Parent SKU for the Variants API).
    • Set the ‘Parentage’ attribute to ‘Child’.
    • Set the ‘Relationship type’ attribute to ‘Variation’.
    • Set the ‘Variation Theme’ attribute to your preferred variation, this has to be the same as the Parent API (the reference table uses ‘Size’).
      Amazon_parent-variant_-_EN_6.png
      Important: Setting a variation theme means you will have to fill in that attribute for the variants with varying values. E.g., variation theme 'size' would mean you will have to fill in 'size' and potentially 'size_map' (if it is mandatory). These relevant attributes are not always on the left side of the attribute builder, and you might need to scroll or Ctrl+f the attribute to find it. 

3. Send your products to Amazon

  1. When finished with the parent and variant APIs, run the parent API and check if the parent products are visible in your Amazon Seller Central account. 
  2. Run the variant API.
  3. If successful, your products will now have a variant menu in the Amazon inventory that looks something like this:
    Amazon_parent-variant_-_EN_7.png

 

If you have followed all the steps in this article and the items are not shown like they are in the image above, please consult our troubleshooter article.