Product feed definitions

This topic provides definitions for the fields in a product feed.

Links to CSV, XML, and XSD feed and response sample files are located on the Sample feed and response files page in this manual.

The Best Practices section in this manual and the Catalog Best Practices Guide provides details and guidelines about Titles, Product Descriptions, Attributes, Picture URLs, and GTINs (UPC, EAN, and ISBN).

You may require category-specific data in your product, distribution and/or combined feeds. eBay provides an Item Specifics Lookup Tool that you can use to look up category IDs and retrieve item specifics metadata for your category selection.

CSV field name

XML field name

eBay Possible Values

Description

Data Type

Use

SKU

SKU

N/A

Stock keeping unit (SKU) identifier. Each SKU must be unique across your entire inventory.

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

string

Required

Localized For

localizedFor

en_AU
de_AT
en_CA
de_DE
es_ES
fr_FR
en_IN
it_IT
ru_RU
en_GB
en_US

Specifies the language that the listing is published in.

string

Required

Variation Group ID

variationGroupID

N/A

The group identifier for a multi-variation listing.

Note (1)

string

Conditional (Required for MSKU)

MSKU:
Variation Specific Name 1

...

Variation Specific Name 5

variationSpecificName

N/A

List of attributes on which the products in the group vary on. Used with Variation Attributes. Limit of 5. Example: {Color, Size}

Note (1)

string

Conditional (Required for MSKU)

Title

title

N/A

The title of the listing. Titles are limited to 80 characters. If you have a longer title, we recommended that you set the full-length title to a CustomField so that it can be used in your product's description template.

Note (1)

string

Required

Subtitle

subtitle

N/A

Additional product information that is shown below the product title.

Note: Subtitles are limited to 55 characters.

Note (1)

string

Optional

Product Description

productDescription

N/A

Text that accurately and completely describes the product. Can be one or more paragraphs.

Note (1)

string

Required

UPC

UPC

N/A

Defines the standard product identifier

string

Optional

ISBN

ISBN

N/A

Defines the standard product identifier

string

Optional

EAN

EAN

N/A

Defines the standard product identifier

string

Optional

MPN

MPN

N/A

Defines the standard product identifier

string

Optional

Brand

Brand

N/A

Defines the product brand

string

Optional

ePID

ePID

N/A

Defines the eBay product identifier

string

Optional

Attribute Name 1
Attribute Value 1

to

Attribute Name 25
Attribute Value 25

 

N/A

Attribute element contains name key and value pairs describing the product attributes. Limit of 25.

 

The format for the attribute values is
a|b|c where a, b, c are the values of an attribute. The values are pipe-separated.

(1)

string

Conditional (depending on the category)

Condition

condition

NEW
NEW_OTHER
NEW_WITH_DEFECTS
MANUFACTURER_
EFURBISHED
SELLER_REFURBISHED
USED_EXCELLENT
USED_VERY_GOOD
USED_GOODUSED_
ACCEPTABLE
FOR_PARTS_OR_NOT_WORKING

Select the condition of the product from the list of choices.

string

Required

Condition Description

conditionDescription

N/A

Additional information about the item condition. Use this field to supplement the standard condition description, such as USED.

This field is optional, must be a text string, and doesn’t have any character limits.

string

Optional

Measurement System

measurementSystem

ENGLISH
METRIC

The unit of measure for shipping weight and size.

ENGLISH: Use lb and in.

METRIC: Use kg and cm

string

Conditional

Length

length

N/A

Measurement of the longest side of the package. Requires the Measurement System field to have a value.

decimal

Conditional

Width

width

N/A

Measurement of the shortest side of the package. Requires the Measurement System field to have a value.

decimal

Conditional

Height

height

N/A

Top to bottom measurement of the package. Requires the Measurement System field to have a value.

decimal

Conditional

Weight Major

weightMajor

N/A

The high whole number portion of the shipping weight. For example, for a shipping weight of 3 lbs, 8 oz., enter 3.

decimal

Conditional

Weight Minor

weightMinor

N/A

The low whole number portion of the shipping weight. For example, for a shipping weight of 3 lbs, 8 oz., enter 8.

decimal

Conditional

Package Type

packageType

BULKY_GOODS
CARAVAN
CARS
EURO_PALLET
EXPANDABLE_TOUGH_BAGS
EXTRA_LARGE_PACK
FURNITURE
INDUSTRY_VEHICLES
LARGE_CANADAPOST_BOX
LARGE_CANADAPOST_BUBBLE_MAILER
LARGE_ENVELOPE
LETTER
MAILING_BOXES
MEDIUM_CANADAPOST_BOX
MEDIUM_CANADAPOST_BUBBLE_MAILER
MOTOR_BIKES
NONE
ONEWAY_PALLET
PACKAGE_THICK_ENVELOPE
PADDED_BAGS
PARCEL_OR_PADDED_ENVELOPE
ROLL
SMALL_CANADAPOST_BOX
SMALL_CANADAPOST_BUBBLE_MAILER
TOUGH_BAGS
USPS_LETTER
USPS_FLAT_RATE_ENVELOPE
USPS_LARGE_PACK
VERY_LARGE_PACK
WINEPAK

The type of shipping package used to ship the product. Specify the Package Type if calculated shipping is used.

string

Conditional

MSKU:
Variation Specific Value 1

to

Variation Specific Value 5

variationSpecificValue 1

N/A

Attribute element contains name key and value pairs describing the variation specifics. Limit of 5.

string

Conditional (Required for MSKU)

Single SKU:
Picture URL 1

 

MSKU:
Pic
ture URL 1

to

Picture URL 24

 

pictureURL

N/A

The list of photo URLs for this product. Limit of 24 URLs/photos per listing, one URL per column in the CSV file.

To list multiple URLs in the Group URL column, separate the URLs with the pipe symbol (|). Do not include spaces before or after the pipe symbol.

Example:

www.server.com\images\image1.png|www. server.com\images\image2.png

Picture URL 1 is used as the main picture. It is repeated for each MSKU.

string

Required

Compatible Product 1

to

Compatible Product 3000

xxxxxxxxxxxxxxxxxxxxxx

compatibleProduct 1

to

compatibleProduct 3000

Use one of three methods to specify the part:

  • Year, Make, Model, Engine, Body, Trim
  • Ktype - UK, DE, and AU only
  • eBay Product ID ( ePID ) - Motorcycles on DE and UK sites only

xxxxxxxxxxxxxxxxxxxxxxxxxxxx

A name-value pair describing a single compatible item. For example, when listing in a Parts & Accessories category, where the items are vehicles, the allowed names might include Year, Make, and Model, and the values would correspond to specific vehicles in eBay's catalog. For example:

  • Make=Toyota | Model=Camry | Year=2011 | Trim=LE Sedan 4-Door

Here are examples of KType and ePID

  • KType=123 and KType = 234
  • ePID=219723271 and ePID=219723281

 

 

string

Conditional

Note:
This will be repeated for each MSKU.