Image Migrator will use the name of the image to match to any of the supported match fields in the image export options. To ensure that the images are attached to the correct products make sure the name of the images matches the value of the match field in the import options and avoid using any illegal characters in the SKU or barcode values on the product in Shopify and in the image file name.

Folders / URL structure

You need to be careful that all of your images are under the same URI or location. You can not have images spread across subfolders as Image Migrator can not see them. If you have created folders for Shoes, Boots, Handbags - Then you will need to run image migrator for each of these seperately.

Image sizes

Your product images can be any size up to 4472 x 4472 px, or 20 megapixels. Product images need to have a file size smaller than 20 MB to be added to Shopify.

High resolution photos look more polished and professional to your customers. For square product images, a size of 2048 x 2048 px usually looks best.

Supported Image Formats

Both jpg and png image formats are supported in the import.

Case sensitive

Image to product matching is case sensitive, make sure your image file names case match the value of the field you specified in the image import options.

Illegal characters

Avoid using the characters below when naming your images and also in the SKU or barcode value on the product.

  • < (less than)
  • > (greater than)
  • : (colon)
  • " (double quote)
  • / (forward slash)
  • \ (backslash)
  • | (vertical bar or pipe)
  • ? (question mark)
  • * (asterisk)

Multiple Product Images

Image Migrator can support up to 10 images per product during import. You can define the position of the image by suffixing the image name with '_<position>.jpg' e.g. for the first position <SKU>_1.jpg, 2nd position <SKU>_2.jpg.

If you only have a single image you can have either <SKU>.jpg or <SKU>_1.jpg.

Given a match value of PURP;


The example below will use the sku value as the match field.

You can have up to 10 images per sku, below is an example of 3 images given a single sku.