This container is a list of Item Specific Name
pairs used by the seller to provide desciptive details of an item in a structured manner.
If creating, revising, or relisting an item with an Add
, or Relist
call, it is recommended that you use the GetCategorySpecifics
call to retrieve mandatory and recommended Item Specifics for a listing category. For ReviseItem only:
When you revise a listing, if an auction listing has one or more bids and ends within 12 hours, you cannot change or add Item Ppecifics. If the auction listing has bids but ends in more than 12 hours, you cannot change existing Item Specifics, but you can add Item Specifics that were not previously included.
If your listing is in a eBay product catalog-enabled category, certain Name
pairs will be accepted as product identifying information. The Name
, or a Global Trade Item Number (GTIN). GTINs are a set of globally recognized identifiers, including
. However, the Values
provided for these Name
s must comply with eBay's constraints or they will not be recognized as product identifiers. The Value
for Brand must be an actual brand name (except that if the item is not branded, Value
.) The Value
for Brand or MPN cannot contain only special characters (e.g.
). All GTINs must comply with international formatting standards. For more details, see Listing with Item Specifics
If the ProductListingDetails
container in an Add/Revise/Relist call is successfully used to find and use an eBay catalog product to create/revise listing, the seller should not remove or change the value of any Item Specific name or value that is defined as part of the eBay catalog product definition. Note: If a listing is associated with an eBay catalog product, the seller does not need to pass in any Item Specifics that are already defined in the eBay catalog product. Sellers can make a GetCategorySpecifics call to see if the listing category supports any 'instance aspects', which can be thought of as Item Specifics that are unique to the specific item that is being listed. Instance aspects are identified in the GetCategorySpecifics response by looking for a value of
Instance in one or more NameRecommendation.ValidationRules.aspectUsage fields. Many categories support the following instance aspects: Custom Bundle, Bundle Description, Modified Item, Modification Description, and California Prop 65 Warning. These instance aspects allow the seller to provide more information about product bundles or modified products in a structured way. Depending on the category, there are other instance aspects as well. For more information about creating bundle listings or modified product listings, see the Associating catalog products to special listings topic. Note: To specify an item's condition, use the ConditionID field instead of a condition Item Specific. Use GetCategoryFeatures to see which categories support ConditionID and to get a list of valid condition IDs. (If you specify ConditionID and you also specify Condition as a Item Specific, eBay drops the condition Item Specific.) For GetItem
: This list is returned only when you specify IncludeItemSpecifics
in the request (and the seller included Item Specifics in their listing).
To delete all Item Specifics when you revise or relist, specify Item.ItemSpecifics
, and don't pass ItemSpecifics
in the request.