TABLE OF CONTENTS

Please read this FAQ fully, Amazon Attribute Mapping is important to successfully list on Amazon.


Overview


Amazon will most definitely require category based attributes to list your products. Category based product attributes are applied in Omnivore.  The Omnivore App is now using the new Amazon API's to add Amazon Attributes.  


Amazon marketplace attributes can be added 3 different ways:

  • Directly in Omnivore
  • Via CSV Upload in Omnivore
  • Using custom attribute data from your website which is imported into Omnivore


Add attributes to a single product


  1. In Omnivore find a product that needs attributes and click the title to view the product page.
  2. Scroll down to view the Amazon Product View section, see Product Attributes and this producttab.
  3. Apply the yellow section first, add text or choose from the drop down options to add data to the marketplace attribute.
  4. TIP- use the i and hover to read helpful prompts.
  5. Stay in the Product Attribute section and complete as many attributes as you can.
  6. When complete on the product page click the Upload to Amazon button.
  7. Along side using the fields to select your own data you can use the Import Attributes button in that section, this will check the Amazon Catalogue and import any attributes based on that Amazon Category.
  8. This completes the steps to apply Amazon attributes to one product in Omnivore.


Next steps to consider:


  1. It is perfectly normal to click upload to Amazon after completing this process only to find that Amazon still require attributes, the validation of attributes with Amazon (in the beginning) is not a one-time add and click experience. Especially with some categories.
  2. After all attributes are added and accepted by Amazon you may see an error about Brand Approval.  Let us know and we can assist with that.  Amazon is strict with brands and brand approval. 
  3. Learning product attribute mapping is the first step, you can also click into the tab on the product page and apply attributes at the category level.
  4. Finally, for Shopify Sellers you can use your own product attributes that exist in Omnivore, these are the attributes we import from your Shopify Metafields


Add attributes to variants


  1. In Omnivore Navigate to Products - On Amazon Australia - Marketplace Attributes Tab.  Under 'Add Attributes By' click Product.
    Search     on a product that has the variants you want to apply your attributes too.
  2. Next to the product title you will see an arrow drop down to open up the view and see the variants associated with that product.  In our case we are adding a size attribute to the variants on a mattress.  
  3. Please note, if there is data in the variant fields this will be applied but if the variant attribute data is empty it will take the product attribute data if there is any.  The parent attribute is the highest priority, any data added to the variant level will then make that variant the priority.  
  4. You can add bullet points in Omnivore at the parent level, now you can also add them at the variant, using the image below, click the arrow down to view your variants and scroll across to see the bullet point fields 1-5, insert your data into each variant field, see here:
  5. On Amazon when you click on the variant, in this case size the bullet points will swap and change.


Add your attributes in bulk


** Be aware of this simple quick guide FAQ here, it could be just what you need to easily add attributes to your products and now also to your variants. ** Also note we are using the new API's and the screens have been updated to make mapping data on the product page easier and more accessible.  


  1. Login to Omnivore and go to 'Products - Amazon' then navigate to the 'Marketplace Attributes' tab
  2. Click Product or Category depending on if you want to add a the product or category level.
  3. We are showing the Product option, on the screen scroll across left to right to view all of the relevant attributes for that category and add your data using the drop downs or by adding text.
  4. After you have added data to the Marketplace Attributes table go to the Dashboard and click 'Upload to Amazon' to sync the new data to your Amazon listings.
  5. After the upload has completed we advise to check some of the products within the category that you applied the attributes to, it is most likely that even after you have applied the attributes Amazon will still require more data and/or there may be new Amazon errors.  It can take two or three times to fully apply the attributes that Amazon require based on the category.   Use our other simple guide FAQ to check a few products and take additional steps. 



Add attributes via CSV


  1. To add Amazon Marketplace attributes via a csv file go to Products - On Amazon Australia and click on the 'Marketplace Attributes' tab.
  2. Click on 'Export attributes to CSV'
  3. This will generate a CSV file of all of your products and any attributes already entered.  You can edit this file to add any new attributes and to add/change values of existing attributes.
  4. After making changes to your CSV file make sure you remove the first two columns which will have the headings 'DELETE FROM IMPORT'.  Also ensure that your productSku formatting is correct.
  5. To upload your new csv file click on the 'Import attributes from CSV' button on the Marketplace Attributes screen.
  6. Select the file you are wanting to upload and then click the upload button.
  7. This will enter the values into the attribute fields in Omnivore, keep your CSV file for your records, hit Upload to Amazon'' to push the data to your live listings.
  8. After the upload has completed we advise to check some of the products within the category that you applied the attributes to, it is most likely that even after you have applied the attributes Amazon will still require more data and/or there may be new Amazon errors.  It can take two or three times to fully apply the attributes that Amazon require based on the category.   Use our other simple guide FAQ to check a few products and take additional steps. 


Adding attributes from your eCommerce store


You will need to add the product attributes to your eCommerce store then Omnivore will import them.  The name of the attributes you create on your eCommerce store will map to the Amazon attribute in Omnivore.  For more information on this see below:


Shopify - useMetadata fields in Shopify

WooCommerce - set up with data mapping from WooCommerce

BigCommerce - use the Custom Fields in BigCommerce

Magento - set up with data mapping from Magento


This is what your mapped fields will look like in Omnivore.

They will then appear as and option for you to choose when adding attribute data to your products in Omnivore.  This screen below is on a product page in Omnivore where you can also directly add product or category data.



Common Amazon Attributes

ManufacturerMinimumAge


All products listed in the Toys & Games category must have a ManufacturerMinimumAge attribute value.  This value is entered in years.


IsExpirationDatedProduct and ShelfLife


Products in the Pantry Food and Drinks category may require both the IsExpirationDatedProduct and ShelfLife attributes to be entered.  


The accepted values for 'IsExpirationDatedProduct' is 'true' or 'false' (yes or no). 

Note: all categories except pantry, beauty, pets, babies will default to False as preset within Omnivore.


'ShelfLife' accepts values in the format '1 day', '3 months'.  A value is required for ShelfLife in the Pantry Food and Drinks category even if IsExpirationDatedProduct is set to 'no'.


Add Bullet Points


Bullet points are a section on the Amazon listing that enables you to add up to 5 bullet points of text; for example: 

As most ecommerce platforms don't have anywhere to store bullet point content, you can add bullet points in Omnivore and we add it to your Amazon listings.


According to Amazon, It is better to keep bullet points clear and concise. A general piece of advice is to keep your bullet points under 1,000 characters in total i.e. for all five bullets, not per bullet. Being less than 1,000 characters improves their readability. If bullet points are indexed for your product, being shorter than 1,000 characters improves discoverability of content in the bullet points.


Adding Bullet Points manually


  1. In Omnivore, in the left navigation menu go to 'Products - On Amazon' then navigate to the 'Marketplace Attributes' tab
  2. In the product table, you will see columns headed bulletPoint1, bulletPoint2 etc up to bulletPoint5. Click into the field 'add text' to enter text. This text will be what appears for each bullet point on amazon.
  3. There is also a field called bulletPoints - you can enter the text for all 5 bullet points in this one field if you separate each bullet point content with a | for example: Red trim|Black leather would show on Amazon as two bullet points:
    • Red trim
    • Black leather



Adding Bullet Points via CSV

  1. You can the import attributes via CSV instead of entering text manually for each bullet point on each product. Click 'Import from CSV'. To create your CSV, just make sure your columns are labelled SKU, bulletPoint1, bulletPoint2 etc 
  2. When you have finished adding text, and importing the CSV file go to the Dashboard and click 'Upload to Amazon'



Add search terms


  1. Note: Amazon Search terms should contain no more than 249 characters including spaces.
  2. In Omnivore in the left navigation menu go to 'Products - Amazon' then navigate to the 'Marketplace Attributes' tab.
  3. In the product table, you will see columns headed Search Terms. Click into the field 'add text' to enter text. This text will be used on Amazon as search terms, not visible on the listing. To separate your search terms use a comma. For example:, base ball, cricket bat, soccer, football
  4. Search terms can be applied using CSV as already mentioned in this article, you can use the same steps.  On the CSV in the Search Terms field use the same data method to separate each search term by a comma.


Map size or colour attributes


  1. There may be instances that require us to map variants like size to an acceptable value that Amazon will accept.
  2. You may see a warning message like this:
  3. Within Omnivore using this example we can map your Variant (Size) to a value Amazon will accept.
  4. If this is the case please contact Support and we can map these for you.  
  5. Please send us the product example link, product name, sku and error so we can assess and provide a solution.


Add dimensions


You can add Item Height, Item Length, Item Width and Item Weight.  To find those fields on the screen you may  need to scroll across to the far right to the end.


Adding the values in the itemHeight, itemlength, itemwidth fields requires unit of measure in centimeters.  

Itemweight is in kilograms.


These can be added the same way as the other attributes.


Key Points - update timing & Amazon does not accept EU sizing


  • Add your attributes including Bullet Points and Search Terms in Omnivore and click and Upload to Amazon we recommend checking back in 24-48 hours to ensure the attributes have been accepted by Amazon. If they have not been accepted you may see a new Blue Warning Message on the product page in Omnivore.If you do continue to see a warning like this it means Amazons has rejected the attribute in which case you will need to check the values added and re-add if required.
  • Amazon does not accept EU sizing.  It has all been standardised to US sizing.  Here is a Seller Central Help Page that addresses this: Shoe size standards FAQ