How do I import images for products successfully?

To import product images successfully, ensure your image field mapping includes all possible image sources from your feed. For XML or JSON feeds with multiple image fields, use a combined JMESPath mapping such as:

{{data | jmespath: '[ItemImageLargeUrl, AlternateItemImages.Img[].Url || AlternateItemImages.Img.Url ][]' | json}}

Additionally, in the Product Images field’s Smart Settings, select "Skip existing images, import new images". This prevents duplicates and allows new images to be fetched correctly. These settings have been confirmed to successfully import all images when alternative or multiple image fields are present.

Important additional checks for successful image import:

• Ensure all image URLs include the required protocol (for example, add "https:" if the feed only provides "//path..."). Missing protocols will cause images to fail fetching.
• If updating images for existing products, make sure the feed’s force override setting is enabled; otherwise images may not update.
• Shopify will set the first URL in the image column as the primary image. Review your feed to ensure the intended featured image is listed first.
• Some image URLs may be unsupported by Shopify. These will be skipped automatically and will not import.

Updated on: 16/07/2026