SIGN UP
Product Submit
Current Product Submit advertisers Sign In
Product Feed Specification
Note: If you are a Yahoo! Merchant Solutions or Yahoo! Store customer, please do not create or upload a product feed. Your products will be pulled directly from your Catalog each time it is published.
Print
We highly recommend you print the spec for future reference
File Name: data.txt
File Format: Tab-delimited text file
First line must contain exact field names
Click for more detailed upload specs
Feed Fields: Refer to charts below
REQUIRED FIELDS
| Field Name | Field Description | Example of Contents |
|---|---|---|
| code | A merchant-specific identifier, or SKU. A unique code must be used for each product and should be kept consistent from feed to feed. | 120xbr233s |
| name | The product name, with no control characters or embedded HTML. | Women's Capri Pants with Cargo Pockets |
| 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. | 100% cotton capri pants with oversized cargo pockets. Available in brown, green and gray; sizes 6,8,10,12. |
| price | Price, in US dollars, with a decimal point and no $ sign. | 95.00 (not $95.00, 95) |
| product-url | The URL that links to the product on your site. You must include http:// in your URLs. |
http://www.yourstore.com/ product/100.html |
| merchant-site- category | The category you use on your own site for each product. Please include your full hierarchy for each entry and separate the different levels with a " > ". | home electronics > audio & video > video > dvd players |
| medium | Required for Music and Video products only
(please leave this field blank for all other product types)
|
For Music, must be one of (not case sensitive): CD, Cassette, MiniDisc, LP, EP, 45
For Video, must be one of (not case sensitive): DVD, VHS, VCD, Beta, 8mm, Laser Disc |
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. |
http://www.yourstore.com/ images/100.jpg |
| Universal Identifiers | ||
| upc | The fully qualified, 12-digit Universal Product Code for the product. Highly recommended for all products. |
104000716021 |
| isbn | For Books only
(please leave this field blank for all other product types) The International Standard Book Number for the product. |
0743260244 |
| brand | The brand of the product, with no control characters or embedded HTML. Highly recommended for Apparel, Home and Garden, and Toy products. |
Levis, All Clad |
| manufacturer |
The manufacturer of the product, with no control characters or embedded HTML. Highly recommended for Computers and Electronics products. |
Hewlett Packard |
| manufacturer- part-no | The manufacturer's unique part number for the product. Do not include your own SKU. Highly recommended for Computers and Electronics products. |
DWS1123M |
| model-no | The model number for the product. Highly recommended for Home and Garden, Computers, and Electronics products. |
BFC-0912 |
| ean | The fully qualified, 13-digit European Article Numbering code for the product. | 7501054530107 |
| 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 |
| condition | The condition of the product. | Must be one of the following (not case sensitive): new, like new, very good, good, acceptable |
| 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 |
| 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-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 |
| 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 |
| nrf-size | The NRF standard size code(s) for the product. Separate multiple codes with a comma. | 10975, 12842, 13003 |
| 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 |
| nrf-color | The NRF standard color code(s) for the product. Separate multiple codes with a comma. | 650, 841, 502 |
| 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. | 29.99 (not $29.99, 29) |
| msrp | The manufacturer's suggested retail price for the item. US dollars, with a decimal point and no $ sign. | 45.00 (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 |
| availability | The number of days before the item will ship. Can be a single number or a span of numbers. | 3, or 5-7 |
| promo-text | You may use this field to relay any special promotions associated with the product. Up to 50 characters of text, with no control characters or embedded HTML. | Free leather case with purchase, Free shipping for orders over $50 |
| 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-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. |
2, 2.5 |
| 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-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 |