eBay Trading API
Call Reference Version 643

Specifies the name of a field to delete from a listing. You cannot delete required fields from a listing.

Some fields are optional when you first list an item (e.g., ListingEnhancement), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them. For example, if GalleryType was already set for the item you are revising, you cannot remove it. Therefore, you still need to include at least one picture URL, a gallery URL, or a catalog stock photo in your revised listing. See the eBay Web Services guide for rules on removing values when revising items. Also see the relevant field descriptions for details on when to use DeletedField (and potential consequences).

The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). DeletedField accepts the following path names, which delete the corresponding nodes:

Item.ApplicationData
Item.AttributeSetArray
Item.BuyItNowPrice
Item.ExtendedSellerContactDetails
Item.ClassifiedAdContactByEmailEnabled
Item.ItemSpecifics
Item.ListingCheckoutRedirectPreference.ProStoresStoreName
Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername
Item.ListingDesigner.LayoutID
Item.ListingDesigner.ThemeID
Item.ListingDetails.MinimumBestOfferMessage
Item.ListingDetails.MinimumBestOfferPrice
Item.ListingEnhancement[Value]
Item.PayPalEmailAddress
Item.PictureDetails.GalleryURL
Item.PictureDetails.PictureURL
Item.PostalCode
Item.ProductListingDetails
Item.SellerContactDetails
Item.SellerContactDetails.CompanyName
Item.SellerContactDetails.County
Item.SellerContactDetails.InternationalStreet
Item.SellerContactDetails.Phone2AreaOrCityCode
Item.SellerContactDetails.Phone2CountryCode
Item.SellerContactDetails.Phone2CountryPrefix
Item.SellerContactDetails.Phone2LocalNumber
Item.SellerContactDetails.PhoneAreaOrCityCode
Item.SellerContactDetails.PhoneCountryCode
Item.SellerContactDetails.PhoneCountryPrefix
Item.SellerContactDetails.PhoneLocalNumber
Item.SellerContactDetails.Street
Item.SellerContactDetails.Street2
Item.ShippingDetails.PaymentInstructions
Item.SKU
Item.SubTitle
These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed.

To delete a listing enhancement like Featured, specify the value you are deleting; for example, Item.ListingEnhancement[Featured]. Listing enhancements can be removed for GTC fixed-price listings only. Listing enhancement removal is supported on the following sites only: AT (16), CA (2), CAFR (210), CH (193), DE (77), IE (205), IT (101), and UK (3).

Required. Child elements hold the values for properties that are changing. The Item.ItemID property must always be set to the ID of the item listing being changed. Set values in the Item object only for those properties that are changing. Use DeletedField to remove a property. Also applicable to Half.com.