Variation Level Images

[Etsy Developer Community]

Hey all,

As many of you know, we recently updated our inventory management systems to support variation level images. Meaning, images can now be applied to specific variations (products) within a listing. You can find more information on this, here.

I'm happy to announce that we just released functionality to support this via our open API. 

You can find the two new methods, getVariationImages and updateVariationImages, here: https://www.etsy.com/developers/documentation/reference/listingvariationimage

It won't be possible to associate images with variations at the time of image uploading. So images should be uploaded to a listing, and then subsequently associated with variations using updateVariationImages.

For context, updateVariationImages calls for the parameter, 'variation_images'. This parameter should be the mapping between the 'property_id' and 'value_id' of the specific product, along with the 'image_id' you'd like to apply to it.

I.E. the body of your request should look something like this:

'variation_images'='[{"property_id": XXX, "value_id": XXX, "image_id": XXX}, {"property_id": XXX, "value_id": XXX, "image_id": XXX}]' 

To retrieve the values for property_id and value_id, you should be using getInventory. You can retrieve the image_ids using findAllListingImages. 

If there are any questions, or if you need further assistance, please contact us at deve...@etsy.com.