The URL of a picture that is associated with the VariationSpecificValue
. A variation specific picture set can consist of up to 12 self-hosted or eBay Picture Services (EPS) hosted pictures. eBay Picture Services and self-hosted images can never be combined into the same variation specific picture set. To specify more than one image, use multiple PictureURL
fields, passing in a distinct URL in each of those fields. This field cannot have an empty/null value. 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.
The image specified in the first PictureURL
field is also used as the thumbnail image for applicable variations. For example, if the picture set contains pictures of red shirts (i.e., VariationSpecificName=Color and VariationSpecificValue=Red), the first picture is used as the thumbnail image for all the red shirt variations. 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.
You can use Item.PictureDetails to specify additional pictures. For example, the item-level pictures could include a model wearing a black shirt, as a typical example of the shirt style. 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.
Variation pictures cannot be added or removed from a fixed-price listing when the listing is scheduled to end within 12 hours or if the item variation has already had transactions. Note: For some large merchants, there are no limitations on when variation pictures can be added or removed from a fixed-price listing, even when the item variation has had transactions or is set to end within 12 hours.