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. Test the exact URL from the feed in a browser or private window. Broken links, connection timeouts, HTTP errors such as 403 or 502, authentication requirements, geo-blocking, and supplier firewalls prevent the sync from downloading the image. Ask the supplier to fix the hosting service 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.

• After the supplier fixes inaccessible URLs, rerun the sync or an image-only Update feed for the affected SKUs.

• 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: 25/08/2026