| REQUIRED FIELDS | ||
| Field Name | Field Description | Example of Contents |
| id | A merchant-specific identifier, or Universal Identifier (see below). A unique code must be used for each product and should be kept consistent. | <id type="merchant">120xbr233s</id> |
| name | The product name, with no control characters or embedded HTML. | <name>Women's Capri Pants with Cargo Pockets</name> |
| description | The product description, with no control characters or embedded HTML. If you do not have product descriptions, you may enter the same data as the ‘name’ field. | <description>100% cotton capri pants with oversized cargo pockets. Available in brown, green and gray; sizes 6,8,10,12.</description> |
| price | Price, with a decimal point and no $ sign. Default is US Dollars. | <price>95.00</price> (not $95.00, 95) |
| product-url | The URL that links to the product on your site. You must include http:// in your URLs. |
<product-url>http://www.yourstore.com/product/100.html</product-url> |
| RECOMMENDED FIELDS | ||
| Field Name | Field Description | Example of Contents |
| image-url | The URL that links to your product image. You must include http:// in your URLs. |
<image-url>http://www.yourstore.com/images/100.jpg</image-url> |
| merchant-site-category | The category you use on your own site for each product. | <merchant-site-category>home electronics</merchant-site-category> |
| medium | Suggested for Music and Video products only | For Music, must be one of (not
case sensitive): CD, Cassette, MiniDisc, LP, EP, 45 <medium>CD</medium> For Video, must be one of (not case sensitive): |
| updated | When the feed was last updated | <updated>2004-10-22 12:03:24</updated> |
| expires | States when the feed expires and should be re-checked | <expires>2004-10-27 12:03:24</expires> |
| location | Zip, city, state or coordinates | <location type="zip">80202</location> |
| Merchant Information | ||
| merchant-name | Your company/store name | <merchant-name>Best Buy</merchant-name> |
| merchant-url | Your sites URL | <merchant-url>http://www.bestbuy.com</merchant-url> |
| merchant-email | Contact email address | <merchant-email>info@mycompany.com</merchant-email> |
| merchant-address | Store address | <merchant-address>123 Main St.</merchant-address> |
| merchant-city | Store city | <merchant-city>Denver</merchant-city> |
| merchant-state | Store state | <merchant-state>CO</merchant-state> |
| merchant-zip | Store zip | <merchant-zip>80223</merchant-zip> |
| merchant-phone | Phone number | <merchant-phone>212-555-1234<merchant-phone> |
| merchant-fax | Fax number | <merchant-fax>212-555-5678</merchant-fax> |
| Universal Identifiers - ID types | ||
| merchant | The unique identifier for a company specific product. | <id type="merchant">MAR-1001</id> |
| upc | The fully qualified, 12-digit Universal Product Code for the product. Highly recommended for all products. |
<id type="upc">104000716021</id> |
| isbn | For Books only
(please leave this field blank for all other product types) The International Standard Book Number for the product. |
<id type="isbn">0743260244</id> |
| asin | Amazon.com ID number. May be depreciated in future revisions. | <id type="asin">B0001A99MO</id> |
| brand | The brand of the product, with no control characters or embedded HTML. Highly recommended for Apparel, Home and Garden, and Toy products. |
<id type="brand">Levis, All Clad</id> |
| manufacturer |
The manufacturer of the product, with no control characters or embedded HTML. Highly recommended for Computers and Electronics products. |
<id type="manufacturer">Hewlett Packard</id> |
| manufacturer-part-number | The manufacturer's unique part number for the product. Do not include your own SKU. Highly recommended for Computers and Electronics products. |
<id type="manufaturer-part-number">DWS1123M</id> |
| model-number | The model number for the product. Highly recommended for Home and Garden, Computers, and Electronics products. |
<id type="model-number">BFC-0912</id> |
| ean | The fully qualified, 13-digit European Article Numbering code for the product. | <id type="upc">7501054530107</id> |
| Product Details | ||
| classification | The classification of the product. | Must be one of the following (not case sensitive): new, used, refurbished, open box, returned, damaged, overstock, liquidation <classification>open box</classification> |
| condition | The condition of the product. | Must be one of the following (not case sensitive): |
| gender | The gender for which the product is intended. Highly recommended for Apparel products. |
Must be one of the following (not case sensitive): male, m, female, f, unisex, or u <gender>u</gender> |
| age-group | The age group for which the product is intended. Highly recommended for Apparel products. |
Must be one of the following (not case sensitive): infant, toddler, child, pre-teen, teen, or adult <age-group>teen,adult</age-group> |
| age-range | The recommended age range for the product. Separate the range with a dash (-) and include the unit (months or years). You may also use "and up" for a range. Highly recommended for Toy products. |
0-6 months, 9 months - 2 years, 2-4 years, 8 years and up <age-range>12 and up</age-range> |
| size | The size(s) in which the product is available. Any format is accepted, but separate multiple sizes with commas. | S,M,L,XL or 6,8,10 or small, medium, large <size>M,XL</size> |
| nrf-size | The NRF standard size code(s) for the product. Separate multiple codes with a comma. | 10975, 12842, 13003 <nrf-size>13003</nrf-size> |
| color | The color(s) in which the product is available. Any format is accepted, but separate multiple colors with commas. | Red or Red, White, Blue, Green, Brown <color>Red, black, pink</color> |
| nrf-color | The NRF standard color code(s) for the product. Separate multiple codes with a comma. | 650, 841, 502 <nrf-color>502</nrf-color> |
| sale-type | The type of sale of the product. Default sale-type is "sale". | sale, auction, rental, swap <sale-type>rental</sale-type> |
| Product Offers | ||
| sale-price | The price of the item if it is currently on sale. Be sure to include the original price of the item in the "price" field. In US dollars, with a decimal point and no $ sign. | <sale-price>29.99</sale-price> (not $29.99, 29) |
| msrp | The manufacturer's suggested retail price for the item. US dollars, with a decimal point and no $ sign. | <msrp>45.00</msrp> (not $45.00, 45) |
| in-stock | Defines if the product is currently in stock on your site. | Must be one of the following (not case sensitive): yes, no, y, or n <in-stock>yes</in-stock> |
| availability | The number of days before the item will ship. Can be a single number or a span of numbers. | 3, or 5-7 <availability>4</availability> |
| promo-text | You may use this field to relay any special promotions associated with the product. | <promo-text>Free leather case with purchase, Free shipping for orders over $50</promo-text> |
| Shipping Information | ||
| shipping-price | The cost of shipping the item anywhere in the United States. US dollars, with a decimal point and no $ sign. Use 0.00 for free shipping. |
9.99 (not $9.99, 9) <shipping-price>0.00</shipping-price> |
| shipping-weight | The weight of the item in pounds, up to one decimal place. Note: Required if you wish to compute shipping estimates based on weight or standard UPS ground rates. |
<shipping-weight>2.5</shipping-weight> |
| shipping-surcharge | An additional surcharge placed on the total shipping cost. US dollars, with a decimal point and no $ sign. |
19.99 (not $19.99, 19) <shipping-surcharge>19.99</shipping-surcharge> |
| shipping-class | User-defined shipping class. Up to 15 alphanumeric characters. Note: Required if you wish to calculate different shipping estimates based on product type. DVDs cost $2.99 to ship whereas the shipping charges for electronics depends on the item price, etc. |
dvd, cd, computers, media, other <shipping-class>media</shipping-class> |