How can I resolve issues with product images not importing correctly?

If product images are not importing correctly, check these common fixes:

• In your feed settings, go to Step 2 → Product Images → Smart Settings and select: "Skip existing images, import new images". This ensures new images are added while keeping existing images unchanged.

• Make sure the Product Images field is correctly mapped. For XML feeds with multiple image sources, you may need a combined mapping such as:
{{data | jmespath: '[ItemImageLargeUrl, AlternateItemImages.Img[].Url || AlternateItemImages.Img.Url ][]' | json}}

• If your manual image order keeps getting overwritten, leave the image field unmapped. Unmapped fields are never updated.

• Make sure the feed actually contains an image value for each affected SKU. If the source API or feed has no image value, mapping cannot create an image; ask the supplier for image data or a feed containing image URLs.

• Image URLs must be direct, public URLs that Shopify can download. If the supplier server or Cloudflare blocks automated requests, ask the supplier to remove the restriction or whitelist 52.20.189.51; Shopify must also be able to fetch the URL. Otherwise, re-host the images on publicly accessible storage, such as Cloudinary, and use the direct image URLs.

• If Shopify adds random numbers to image filenames, this is normal. Shopify does this automatically when very similar images are uploaded.

If issues persist, try reverting the previous process and rerunning the feed for an affected SKU, or run an update feed mapped only to images to refresh missing media.

Updated on: 04/08/2026