Contains the URL for a picture of the item. The URL can be from the eBay Picture Services (images previously uploaded) or from a server outside of eBay (self-hosted). You can pass in up to 12 picture URLs (for most categories and marketplaces) for each listing, but you cannot mix self-hosted and EPS-hosted URLs in the same listing. The
UploadSiteHostedPictures call can be used to upload pictures to EPS. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. URLs using the 'http' protocol will not be allowed.
Note: If a URL contains spaces, those spaces can be replaced with %20
. For example, https://example.com/my image.jpg
must be submitted as https://example.com/my%20image.jpg
to replace the space in the image file name. However, a semicolon character (;) cannot be replaced with %20
, so a semicolon cannot be a part of the URL, as an error will occur. On the US and Canada eBay Motors sites (for all vehicle listings) a listing can contain up to 24 pictures. The Gallery image will be the first
PictureURL in the array of
PictureURL fields.
Note: All images, whether they are hosted by EPS or self-hosted, must comply with eBay picture requirements, including the requirement that all images must be at least 500 pixels on its longest side. If the image does not satisfy the 500 pixels requirement, the listing may be blocked. For more information about other requirements and tips for adding pictures to listings, see the Adding pictures to your listings help page. To specify multiple pictures, send each URL in a separate,
PictureDetails.PictureURL element. The first URL passed in defaults to be the 'gallery image', and will be the first picture that is shown when a user lands on the View Item page.
If a listing uses a single, self-hosted picture (except in the case of a multiple-variation listing), the picture will be copied to eBay Picture Services (EPS) and the
PictureDetails.PictureURL value returned by
GetItem will be an EPS URL.
For VerifyAddItem only: You must include a picture even when using
VerifyAddItem. If you don't have a image file, you can use the following fake eBay Picture Services URL (https://i2.ebayimg.com/abc/M28/dummy.jpg) with this call.
For ReviseItem and RelistItem only: To remove a picture when revising or relisting an item, specify
PictureDetails with all the pictures that you want the listing to include. That is, you need to completely replace the original set of URLs with the revised set. You cannot remove all the
PictureURL fields from a listing because each listing requires at least one picture.
Remember: The 'gallery image' will be the first
PictureURL in the array of
PictureURL fields. So, if the first image passed in when relisting/revising is different from when the listing was created, the 'gallery image' will be changed.
Note: For some large merchants, there are no limitations on when pictures can be added or removed from a fixed-price listing, even when the listing has had transactions or is set to end within 12 hours.