Working with Item Specifics

Item Specifics are details about the item being sold. Depending on the listing category, some Item Specifics are mandatory, some are recommended, and others are custom-designed by the seller. Item Specifics can help users find your item in a search, and can help prospective buyers quickly learn about your item.


Item Specifics enable you to classify items by presenting descriptive details in a structured manner. For example:

That is, information like "Total Carat Weight" would be specific to jewelry listings, and information like "Type=Top-Loading" would be specific to Washer & Dryer listings.

Each Item Specific consists of a name (like "Total Carat Weight") and a value (like "3.00 carats and larger").

The figure below shows some Item Specifics for a gold bracelet listing, similar to how they might appear on eBay's View Item page.

Item Specifics
 Figure: Item Specifics on eBay's View Item Page

Buyers and sellers can use Item Specifics to find and compare particular types of items more easily when searching and browsing eBay.

By using Item Specifics in listings, sellers can also benefit in these ways:

In the API, Item Specifics are name/value pairs (simple strings). A seller chooses from a list of the most popular field names and values defined by other users, and/or defines their own field names and values. In the API, you use the names and values the seller specified (as-is) when you list or display an item.

Item Specifics are not supported in all categories. This chapter includes information on how you use the API to determine the categories that do support Item Specifics.

Item specifics can be included in a listing via three mechanisms: