Amazon XML Product Feed Integration Guide (MWS)

Integrating with Amazon’s MWS for XML integration can be a pain, especially since the small amount of documentation written on the subject is often contradictory and unclear. This guide should help point you in the right direction. To be clear, this guide will only focus its attention to the xml file itself. That is, this guide will explain what each tag means and what best to include in each tag for SEO/ranking higher on amazon. This guide will NOT cover: How to implement these notes. You or your team must already have a programmer to implement the XML file. This guide is about how best to utilize the tags provided in the schema.

How to Use the Guide

  • All text in bold is a tag; subtags are marked by a bullet point. Tag descriptions and specifications are not bolded.
  • To completely add a product via XML, you’ll need to upload four different XML files: Product.xml, productimage.xml, inventory.xml and price.xml. This guide is sorted into these four files.
  • This guide was written with home decor as an example category, so some tags might not apply to your product.
  • Be sure to complete as many tags and possible and be sure to follow these guidelines as closely as possible to ensure that your product ranks as high as possible.
  • Each item must be sent as a new message in the messageID tag. This is present in each of the xml files however message ID’s do not need to match to add information about the same product.

Sample Product XML

The two links below contain sample xml files:

Product XML Tag Guide and Reference

Sample of completed product.xml (see below for information about each tag)

<?xml version=”1.0″?> <AmazonEnvelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xsi:noNamespaceSchemaLocation=”amzn-envelope.xsd”> <Header> <DocumentVersion>1.01</DocumentVersion><MerchantIdentifier>XXXXXXXXXXXXX</MerchantIdentifier> </Header> <MessageType>Product</MessageType><PurgeAndReplace>false</PurgeAndReplace> <Message> <MessageID>1</MessageID> <OperationType>Update</OperationType> <Product> <SKU>220</SKU> <StandardProductID> <Type>UPC</Type> <Value>680242554716</Value> </StandardProductID> <ProductTaxCode>A_GEN_TAX</ProductTaxCode> <LaunchDate>2014-04-22T04:00:00</LaunchDate> <Condition> <ConditionType>New</ConditionType> </Condition> <DescriptionData> <Title>Home Decor Company Hand woven Chobi Sumak 5-Feet 6-Inch by 8-Feet 6-Inch Wool Sumak, Aqua 2, Beige, Copper, Cream</Title><Brand>Home Decor Company</Brand> <Description>These luxurious flat-woven rugs are handmade by Afghan master weavers. They are woven using locally handspun wool and the beautiful variety of colors and hues is achieved by using vegetable and mineral dyes. These stately rugs are perfect for traditional, classical and modern decors.</Description><BulletPoint>High-density polypropylene pile provides one of the plushest feelings available in a rug</BulletPoint> <BulletPoint>Intricate yet understated design with a scrolling vine pattern provides depth and textural appeal</BulletPoint> <BulletPoint>Imported from India</BulletPoint> <BulletPoint> Flat-weave and constructed from 100% Wool with 100% Cotton foundation</BulletPoint> <BulletPoint>5-Feet 6-Inch by 8-Feet 6-Inch (167cm x 259cm)</BulletPoint><ItemDimensions> <Length unitOfMeasure=”CM”>259</Length> <Width unitOfMeasure=”CM”>167</Width> <Height unitOfMeasure=”CM”>0</Height> <Weight unitOfMeasure=”LB”>27.9</Weight> </ItemDimensions> <PackageDimensions> <Length unitOfMeasure=”CM”>259</Length> <Width unitOfMeasure=”CM”>167</Width> <Height unitOfMeasure=”CM”>0</Height> </PackageDimensions> <PackageWeight unitOfMeasure=”LB”>27.9</PackageWeight> <ShippingWeight unitOfMeasure=”LB”>27.9</ShippingWeight> <MSRP currency=”CAD”>941.90</MSRP><Manufacturer>Home Decor Company</Manufacturer><MfrPartNumber>220</MfrPartNumber><SearchTerms>arpet;bedrooms;carpet;carpets;carpt;cheap;crpet</SearchTerms><SearchTerms>decor;expensive;flat;flatweave;home;kids;kitchen</SearchTerms> <SearchTerms>less;living;luxury;new;pakistan;pakistani;panel</SearchTerms><SearchTerms>quality;rectangle;rectangular;rgs;room;rug;rugs</SearchTerms><SearchTerms>sale;transitional;vintage;weave</SearchTerms><UsedFor>bedroom</UsedFor> <UsedFor>living room</UsedFor> <UsedFor>dining room</UsedFor> <UsedFor>floor</UsedFor> <UsedFor>decor</UsedFor> <ItemType>handmade-rugs</ItemType><OtherItemAttributes>Rectangular</OtherItemAttributes><OtherItemAttributes>Panel</OtherItemAttributes><OtherItemAttributes>Transitional</OtherItemAttributes><OtherItemAttributes>Artisan</OtherItemAttributes><OtherItemAttributes>Urban</OtherItemAttributes><TargetAudience>Adults</TargetAudience><TargetAudience>Children</TargetAudience><TargetAudience>Men</TargetAudience><TargetAudience>Women</TargetAudience><RecommendedBrowseNode>6647000011</RecommendedBrowseNode><RecommendedBrowseNode>6647007011</RecommendedBrowseNode></DescriptionData> <ProductData> <Home> <ProductType> <FurnitureAndDecor> <ColorMap>Green</ColorMap> <Material>Wool & Wool Blend</Material> <!–<MaximumCoverageArea unitOfMeasure=”square-cm”>18581</MaximumCoverageArea>–> <Shape>Rectangular</Shape> <VariationData> <Size>6′ x 9′</Size> <Color>Green</Color> <StyleName>Contemporary</StyleName> </VariationData> </FurnitureAndDecor> </ProductType> <!–<VariationData> <VariationTheme> <Size>5 x 8</Size> </VariationTheme> </VariationData>–> <CountryAsLabeled>PK</CountryAsLabeled><CountryOfOrigin>PK</CountryOfOrigin><CountryProducedIn>Pakistan</CountryProducedIn><ImportDesignation>Imported</ImportDesignation> <FabricType>100% Wool</FabricType><PatternName>Geometric</PatternName> <DisplayLength unitOfMeasure=”CM”>259</DisplayLength> <DisplayWidth unitOfMeasure=”CM”>167</DisplayWidth> <DisplayWeight unitOfMeasure=”LB”>27.9</DisplayWeight> <ManufacturerWarrantyDescription>30-day Money Back Guarantee </ManufacturerWarrantyDescription> </Home> </ProductData> </Product> </Message> </AmazonEnvelope>

Tag Information

Remember! Each tag is in bold, sabotages are the bolded and bulleted text. Explanations is the normal weight text.

SKU

  • Our SKU

Standard ProductID

  • Type
    • ASIN preferred; UPC if not available
  • Value
    • The value

ProductTaxCode

  • A_GEN_TAX

LaunchDate

  • The on which date feed is generated

DiscontinueDate

  • Ignore

ReleaseDate

  • The date product is to be released. 99% of the time this will be the launch date.

ExternalProductURL

  • Ignore

OffAmazonChannel

  • Ignore

OnAmazonChannel

  • Ignore

Condition

  • ConditionType
    • Must be one of the following: New, UsedLikeNew, UsedVeryGood, Refurbished
  • ConditionNote (Only if condition type is not new)
    • Note about condition – Max 2000 chars

Rebate

  • This can be left empty unless we plan on offering rebates

ItemPackageQuantity

  • Ignore: Our delivered packages are only one package

Number of Items

  • Ignore: When someone orders a rug, it is the only item that is sent

LiquidVolume

  • Ignore

DescriptionData

  • Title
    • If material is NOT synthetic
      • [Company name] + [Collection] +[Width] + [Unit of Measure Spelled out] +[Length] + [Unit of Measure Spelled out] + [Material] + [Item Type] + “,” + Colour
        • For example: Home Decor Company Royal 5’5” x 7’8” Wool Rug, Red
    • If material IS synthetic
      • [Company name] + [Collection] +[Width] + [Unit of Measure Spelled out] +[Length] + [Unit of Measure Spelled out] + [Item Type] + “,” + Colour
        • For example: Home Decor Company Royal 5’5” x 7’8” Rug, Red
  • Brand
  • [Company name]
  • Designer
  • Not sure if ignore or not
  • Description
  • Product romance statement – Max 2000 chars
  • BulletPoint (1)
  • Small description
  • BulletPoint (2)
  • [Style] + “style” + [Construction Type] + “made” + [Item Type]
  • BulletPoint (3)
  • If not made in CA or USA
    • Imported from + [Country of Origin]
  • If made in CA or USA
    • Proudly(?) Made in + [Country of Origin]
  • BulletPoint (4)
  • [Material]
  • BulletPoint (5)
  • If uploading to US
    • [Size] + “Feet”
  • if Canada
    • [Size] + “Feet ([SizeMeters] + “Meters)”
  • ItemDimensions (each of the following can be excluded safely)
  • Length (with name=unitOfMeasure [CM,M,IN,FT])
    • Value
  • Width (with name=unitOfMeasure [CM,M,IN,FT])
    • Value
  • Height (with name=unitOfMeasure [CM,M,IN,FT])
  • Value
  • Weight (with name=unitOfMeasure [LB,KG])
  • Value
  • PackageDimensions
  • Length (with name=unitOfMeasure [CM,M,IN,FT])
    • Value
  • Width (with name=unitOfMeasure [CM,M,IN,FT])
    • Value
  • Height (with name=unitOfMeasure [CM,M,IN,FT])
    • Value
  • PackageWeight (with name=unitOfMeasure [LB,KG])
  • ShippingWeight (with name=unitOfMeasure [LB,KG])
  • MerchantCatalogNumber
    • For pro merchants only
  • MSRP (with name=currency [USD,CAD])
    • Value
  • MSRPWithTax (with name=currency [USD,CAD])
    • Value
  • MaxOrderQuantity
    • Positive integer
  • SerialNumberRequired
    • True/False
  • Prop65
    • Ignore if not located in California
  • CPSIAWarning
    • no_warning_applicable
  • CPSIAWarningDescription
    • Ignore
  • LegalDisclaimer
    • Ignore
  • Manufacturer
    • [Company name]
  • MfrPartNumber
    • The SKU
  • SearchTerms (1)
    • Comma delimited max 50 chars
  • SearchTerms (2)
    • Comma delimited max 50 chars
  • SearchTerms (3)
    • Comma delimited max 50 chars
  • SearchTerms (4)
    • Comma delimited max 50 chars
  • SearchTerms (5)
    • Comma delimited max 50 chars
  • PlatinumKeywords
    • Ignore
  • Memorabilia
    • False
  • Autographed
    • False
  • UsedFor (1)
    • dining room
  • UsedFor (2)
    • living room
  • UsedFor (3)
    • decor
  • UsedFor (4)
    • floor
  • UsedFor (5)
    • bedroom
  • ItemType
    • area-rugs
    • braided-rugs
    • hand-knotted-rugs
    • handmade-rugs
    • hand-tufted-rugs
    • machine-made-rugs
    • runners
  • OtherItemAttributes (Can only be one of the follows terms)
    • Casual, Chic, Contemporary, Decorative, Rectangular, Art Deco, Asian Influence, Casual, Checkered, Colonial, Contemporary, Country, Rustic, Decorative, Floral French, French Country, Garden, Handmade Rugs, Lodge, Natural Fiber Rugs, Nonskid, Nonstandard, Shape, Novelty, Oval, Patchwork Patterns, Print, Rectangular, Round, Santa Fe, Shabby, Chic, Solid, Square, Striped, Traditional, Victorian
  • OtherItemAttributes (Can only be one of the follows terms)
    • Casual, Chic, Contemporary, Decorative, Rectangular, Art Deco, Asian Influence, Casual, Checkered, Colonial, Contemporary, Country, Rustic, Decorative, Floral French, French Country, Garden, Handmade Rugs, Lodge, Natural Fiber Rugs, Nonskid, Nonstandard, Shape, Novelty, Oval, Patchwork Patterns, Print, Rectangular, Round, Santa Fe, Shabby, Chic, Solid, Square, Striped, Traditional, Victorian
  • OtherItemAttributes (Can only be one of the follows terms)
    • Casual, Chic, Contemporary, Decorative, Rectangular, Art Deco, Asian Influence, Casual, Checkered, Colonial, Contemporary, Country, Rustic, Decorative, Floral French, French Country, Garden, Handmade Rugs, Lodge, Natural Fiber Rugs, Nonskid, Nonstandard, Shape, Novelty, Oval, Patchwork Patterns, Print, Rectangular, Round, Santa Fe, Shabby, Chic, Solid, Square, Striped, Traditional, Victorian
  • OtherItemAttributes (Can only be one of the follows terms)
    • Casual, Chic, Contemporary, Decorative, Rectangular, Art Deco, Asian Influence, Casual, Checkered, Colonial, Contemporary, Country, Rustic, Decorative, Floral French, French Country, Garden, Handmade Rugs, Lodge, Natural Fiber Rugs, Nonskid, Nonstandard, Shape, Novelty, Oval, Patchwork Patterns, Print, Rectangular, Round, Santa Fe, Shabby, Chic, Solid, Square, Striped, Traditional, Victorian
  • OtherItemAttributes (Can only be one of the follows terms)
    • Casual, Chic, Contemporary, Decorative, Rectangular, Art Deco, Asian Influence, Casual, Checkered, Colonial, Contemporary, Country, Rustic, Decorative, Floral French, French Country, Garden, Handmade Rugs, Lodge, Natural Fiber Rugs, Nonskid, Nonstandard, Shape, Novelty, Oval, Patchwork Patterns, Print, Rectangular, Round, Santa Fe, Shabby, Chic, Solid, Square, Striped, Traditional, Victorian
  • TargetAudience
    • Adults
  • TargetAudience
    • Children
  • TargetAudience
    • Men
  • TargetAudience
    • Women
  • SubjectContent
    • Ignore
  • IsGiftWrapAvailable
    • Can be left as True since it will fill up some white space on your listing
  • IsGiftMessageAvailable
    • Boolean
  • PromotionKeywords
    • Haven’t found any information on this, probably for special amazon members
  • IsDiscontinuedByManufacturer
    • Ignore
  • DeliveryScheduleGroupID
    • Ignore
  • DeliveryChannel
    • Ignore
  • PurchasingChannel
    • Ignore
  • MaxAggregateShipQuantity
    • Ignore (Max amount of these items which may be shipped at the same time)
  • IsCustomizable
    • False
  • CustomizableTemplateName
    • Ignore
  • RecommendedBrowseNode (1 – CA only)
    • All Area Rugs: 6647000011
    • RecommendedBrowseNode (2 – CA only)
      • Braided: 6647002011
      • Hand-knotted: 6647005011
      • Hand tufted: 6647006011
      • Handmade: 6647007011
      • Handloomed: 6647007011
      • Machinemade: 6647008011
      • Runner: 6647010011
  • FEDAS_ID
    • Ignore
  • TSDAgeWarning
    • Ignore
  • TSDWarning
    • Ignore
  • TSDLanguage
    • Ignore
  • OptionalPaymentTypeExclusion
    • Ignore

END DESCRIPTION DATA TAG

PromoTag

  • PromoTagType
    • Value must be one of the following: Sale, New, NewArrival, WebOnly, Clearance, LimitedOffer, SpecialOffer, SpecialPurchase, OnlyInStores
  • EffectiveFromDate
    • Format: 2002-09-24
  • EffectiveThroughDate
    • Format: 2002-09-24

DiscoveryData

  • Ignore
  • Priority
    • Ignore
  • BrowseExclusion
    • Ignore
  • RecommendationExclusion
    • Ignore

ProductData

  • Home
  • ProductType
  • FurnitureAndDecor
  • ColorMap
  • Color Map must be one of the following: beige, black, blue, brown, Clear, Gold, Green, Grey (correct spelling for both CA and USA), Ivory, Multi, Orange, Pink, Purple, Red, Silver, White, Yellow
  • IsStainResistant
    • Boolean
  • Material
    • Aluminum, Bamboo, Bamboo-derived rayon, Beech, Birch, Brass, Bronze, Cashmere, Cast Iron, Cedar, Chenille, Cherry, Chrome, Copper, Cotton, Denim, Down & Feather-Fill, Elm, Fabric, Flannel, Fleece, Glass, Hardwood, Jersey, Leather & Suede, Leather, Mahogany, Maple, Marble, Memory foam, Metal, Microfiber, Nickel, Oak, Other, Paper, Paraffin, Percale, Pewter, Pine, Plastic, Polycast, Polyester & Polyester Blend, Polyresin, Polyurethane, Porcelain, Rattan, Rattan & Wicker, Recycled Material, Rosewood, Resin, Sateen, Satin, Silk, Silver, Stainless Steel, Steel, Stone, Straw, Suede, Synthetic, Teak, Terrycloth, Tin, Velvet, Vinyl, Wax, Wicker, Walnut, Willow, Wood, Wool & Wool Blend, Wrought and Cast Iron,
    • Max 50 chars – Must be one of the following: Acrylic, Acrylic Linen, Denim, Denim & Chambray, Down & Feather-Fill, Felt, Faux Fur, Fleece, Flannel, Hemp, Leather, Leather & Suede, Linen, Natural, Multi-Ply, Microfiber, Nylon, Polyester, Polyester & Polyester Blend, Polyurethane, Recycled Material, Recylced, Silk, Synthetic, Wool, Velvet, Wool & Wool Blend
  • MaximumCoverageArea (name = unitOfMeasure [square-ft, square-in, square-cm)
    • Value
  • Shape
    • Oval, Rectangular, Round or Square
  • VariationData
  • Size
    • 2’x3’,
    • 2.5’ x 9’,
    • 2.5’ x 13’,
    • 3’ x 5’,
    • 4’ x 6’,
    • 5’ x 8’,
    • 6’ x 9’,
    • 8’ x 10’,
    • 9’ x 12’,
    • Round,
    • Square
  • Color
    • Color spelt out (string)
  • StyleName
    • Must be one of the following: Antique, Art Deco, Asian, Baroque, Cape Cod, Casual, Chinese, Colonial, Contemporary, Cottage, Country Rustic, Eclectic, English, French, French Country, Garden, Italianate, Japanese, Latin, Lodge, Mediterranean, Mission, Modern, Moroccan, Old World, Scandanavian, Shabby Chic, Shaker, Southwestern, Traditional, Tropical, Victorian
  • CountryAsLabeled
    • Must be 2 char country code
  • CountryOfOrigin
    • Must be 2 char country code
  • CountryProducedIn
    • Full country name
  • ImportDesignation
    • If posting from CA account and country of origin is not Canada then put “Imported”, else “Made in Canada
    • If posting from USA account and country of origin is not USA then put “Imported”, else “Made in USA”
  • FabricType
    • 100 chars long, each fabric separated by a “/” and numerated with a % amount
  • PatternName
    • Must be one of the following: Floral, Solid, Striped, Print, Geometric, Patchwork, Paisley, Bordered, Plaid, Checkered, Polka Dot, Gingham, Moire
  • DisplayLength (name = unitOfMeasure [FT])
    • Must be in feet
  • DisplayWidth (name = unitOfMeasure [FT])
    • Must be in feet
  • DisplayWeight (name = unitOfMeasure [LB])
    • Must be in pounds
  • ManufacturerWarrantyDescription
    • 30-day Money Back Guarantee

 

Inventory XML

Sample inventory.xml

<?xml version=”1.0″ encoding=”utf-8″ ?> <AmazonEnvelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”; xsi:noNamespaceSchemaLocation=”amzn-envelope.xsd”><Header> <DocumentVersion>1.01</DocumentVersion><MerchantIdentifier>M_SELLER_XXXXXX</MerchantIdentifier> </Header> <MessageType>Inventory</MessageType> <Message> <MessageID>1</MessageID> <OperationType>Update</OperationType> <Inventory> <SKU>ASUSVNA1</SKU> <Quantity>8</Quantity> <FulfillmentLatency>1</FulfillmentLatency> </Inventory> </Message> <Message> <MessageID>2</MessageID> <OperationType>Update</OperationType> <Inventory> <SKU>ASUS8VM</SKU> <Quantity>6</Quantity> <FulfillmentLatency>1</FulfillmentLatency> </Inventory> </Message> </AmazonEnvelope>

Inventory XML Dictionary

Inventory

  • SKU
    • SKU
  • Quantity
    • Quantity
  • FulfillmentLatency
  • Amount of days it takes from receiving order to shipping

Price XML

<?xml version=”1.0″ encoding=”utf-8″ ?> <AmazonEnvelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”; xsi:noNamespaceSchemaLocation=”amzn-envelope.xsd”><Header> <DocumentVersion>1.01</DocumentVersion><MerchantIdentifier>M_SELLER_XXXXXX</MerchantIdentifier> </Header> <MessageType>Price</MessageType> <Message> <MessageID>1</MessageID> <Price> <SKU>ASUSVNA1</SKU> <StandardPrice currency=”USD”>10.99</StandardPrice> </Price> </Message> <Message> <MessageID>2</MessageID> <Price> <SKU>ASUSVNA1669</SKU> <StandardPrice currency=”USD”>204.99</StandardPrice> <Sale> <StartDate>2008-10-01T00:00:00Z</StartDate> <EndDate>2009-01-31T00:00:00Z</EndDate> <SalePrice currency=”USD”>28.38</SalePrice> </Sale> </Price> </Message> </AmazonEnvelope>

Price XML Dictionary

Price

  • SKU
    • SKU
  • StandardPrice (name=currency [CAD,USD])
    • Price item will be sold at
  • Sale
  • StartDate
    • Date long format
  • EndDate
    • Date long format
  • SalePrice (name=currency [CAD,USD])
    • Sale price

ProductImage XML

<?xml version=”1.0″ encoding=”utf-8″ ?> <AmazonEnvelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”; xsi:noNamespaceSchemaLocation=”amzn-envelope.xsd”><Header> <DocumentVersion>1.01</DocumentVersion><MerchantIdentifier>M_SELLER_XXXXXX</MerchantIdentifier> </Header> <MessageType>ProductImage</MessageType> <Message> <MessageID>1</MessageID> <OperationType>Update</OperationType> <ProductImage> <SKU>ASUSVNA1</SKU> <ImageType>Main</ImageType><ImageLocation>http://www.abc.com/images/ASUSVNA1.gif</ImageLocation&gt; </ProductImage> </Message> <Message> <MessageID>2</MessageID> <OperationType>Update</OperationType> <ProductImage> <SKU>ASUSVNA1987/4G</SKU> <ImageType>Main</ImageType> <ImageLocation>http://www.abc.com/images/ASUSVNA1987.jpg</ImageLocation&gt; </ProductImage> </Message> </AmazonEnvelope>

Price XML Dictionary

ProductImage

  • SKU
  • SKU
  • ImageType (one of the following)
    • Main: Main image
    • Swatch: different colour variations (will be rescaled to 30×30 pixels)
    • Alternate (PT1-8): Secondary photos to be displayed alongside others
  • ImageLocation
    • URL where image is located

Image Requirements

Format – photographs, not drawings

Color Model – RGB (no CMYK images)

Background – white or clear, no borders or words, no brand logos

Recommended dimensions – Images should be 1000 pixels or larger in either height or width as this will

enable zoom functionality on the website (zoom has proven to enhance sales). The smallest your file should

be is 500 pixels on the longest side. Consistently sized images are strongly recommended.

File type – JPEG (.jpg) or GIF (.gif)

Resolution – 72 pixels per inch

Animation – none

Found this guide useful? Feeling generous?