Product Image

Version 2019-10

Products are easier to sell if customers can see pictures of them, which is why there are product images.

Any product may have up to 250 images, and images can be in .png, .gif or .jpg format.

Best practices for naming image files

To successfully upload or update images, follow these best practices when naming your image files:

  • Don't use spaces in the file name. Example: my file name.png
  • Don't begin your file name with symbols, like "!". Example: !my_file_name.png
  • Avoid using periods before the file extension. Example: my_file_name..png
  • Avoid long, complicated file names that contain excess characters.

    Example: my_---_file_---_name_---.png

What you can do with Product Image

The Shopify API lets you do the following with the Product Image resource. More detailed versions of these general actions may be available:

Product Image properties

"created_at": "2012-03-13T16:09:58-04:00"

The date and time when the product image was created. The API returns this value in ISO 8601 format.

"id": 850703190

A unique numeric identifier for the product image.

"position": 1

The order of the product image in the list. The first product image is at position 1 and is the "main" image for the product.

"product_id": 632910392

The id of the product associated with the image.

"variant_ids": [

An array of variant ids associated with the image.

"src": ""