How to handle missing images?
If product images do not appear after an import, this guide walks you through the most common causes and how to fix them. It helps you import missing images without duplicating the ones already in your store.
Common Reasons Images May Be Missing
If product images do not appear after import, check the following:
- Make sure the image URLs in the feed are valid and publicly accessible.
- Confirm the URLs use the correct protocol (for example, HTTPS if required by the store platform).
- Verify that the Image URL field is mapped to the correct column in the feed.
- If several image URLs are provided in one cell, make sure the Image Column Separator matches the file format. For example, change the separator from Auto to a pipe (|) if commas appear inside the image URLs.
Skip Existing Images Settings
1. First Import (Initial Upload)
When images are imported for the first time, all selected images are added to the product.
Example:
- image1.jpg
- image2.jpg
Result:
- image1.jpg
- image2.jpg
2. Skip Existing Images: Disabled
When Skip Existing Images is disabled, the system does not check for duplicates.

Behavior:
- Existing images may be re-imported.
- Duplicate images can occur.
Example Input:
image1.jpg, image2.jpgResult:
- image1.jpg
- image2.jpg
Note: If the same images are uploaded again, they may overwrite or duplicate depending on system rules.
3. Skip Existing Images: Enabled
When Skip Existing Images is enabled, the system checks for images that already exist and imports only new ones. Use this setting to upload only missing images after an initial import.
For products with duplicate records or multiple variants sharing the same product identifier, also enable Update duplicate products with same product identifier in the Product Identifier settings. This allows the update feed to apply the image update to all duplicate products, not only the first variant.
Behavior:
- Existing images are skipped.
- Only new images are added.
- Duplicate products with the same product identifier are updated when the duplicate-product option is enabled.
Example Input:
image1.jpg, image2.jpg, image3.jpgResult:
- image1.jpg
- image2.jpg
- image3.jpg (new)
To upload only missing images:
- Create or use an Update feed containing the product identifiers and image URLs.
- In the Image settings, select Skip existing images, import new images.
- If the product has duplicate records or multiple variants with the same product identifier, enable Update duplicate products with same product identifier.
- Run the update feed, preferably as a test on a sample product first.
4. Issue: Duplicate Images with Skip Existing Images Enabled
If duplicate images exist in the update source and Skip Existing Images is enabled, duplicates may still be imported as new entries.

Behavior:
- Duplicate files are treated as new uploads.
- Multiple copies of the same image can appear.
Example Input:
image1.jpg, image1.jpg, image2.jpg, image2.jpg, image3.jpgResult:
- image1.jpg
- image1.jpg (new)
- image2.jpg
- image2.jpg (new)
- image3.jpg (new)
Total Images: 5
5. Solution: Replace Images and Skip Existing Images Together
When both Replace Images and Skip Existing Images are enabled, the system performs a full refresh. This is recommended for a clean re-import.


Behavior:
- Clears all existing images.
- Reimports all images as new.
- Prevents duplicates and ensures a clean image set.
Example Input:
image1.jpg, image2.jpg, image3.jpgProcess:
- Clear all existing images
- Reimport all images
Result:
- image1.jpg (new)
- image2.jpg (new)
- image3.jpg (new)
Troubleshooting Sequence for Missing Images
- Compare affected SKUs: Select an affected SKU and compare it with a working SKU. Confirm the corresponding feed row contains a valid image value and is not excluded by filters. A product may have an image on one variant but not another, and an update cannot add an image that is missing from that variant's row.
- Verify URL accessibility: Make sure the image URL is direct and publicly accessible, without logins, cloud locks, or geo-blocking.
- Check field mapping: Confirm the image field is mapped to Product Images. If image data spans multiple XML fields, combine them in the mapping settings.
- Fix parsing and formatting: Set the Image Column Separator to
|if URLs contain commas. If paths begin with//, enable Smart Settings to prepend https:. - Check variant grouping: If sizes or colors were imported as separate products, make sure Variant group is mapped along with the size and color fields. Incorrect grouping can prevent an image update from reaching the right product or variant.
- Test sample batches: Run a test import or update on 2–3 SKUs. For large catalogs, process items in smaller batches to avoid server timeouts.
- Use an image-only update feed: For existing Shopify products, create an Update Feed and select Skip existing images, import new images in Smart Settings.
Common Causes & Solutions
- Missing HTTPS prefix: If URLs begin with
//, enable Smart Settings to prepend https:. - Image proxy or remote image errors: If logs show
Error getting remote imageorUnsupported Media Type, disable Use image CDN in the feed settings. - Comma separators in URLs: Change the Image Column Separator from Auto to
|(pipe) to parse URLs containing commas correctly. - Multiple XML image fields: Combine split XML image nodes using JMESPath:
{{data | jmespath: '[ItemImageLargeUrl, AlternateItemImages.Img[].Url || AlternateItemImages.Img.Url ][]' | json}}- Server timeouts or batch limits: High-volume imports may trigger supplier rate limits or connection timeouts. Reduce the batch size to 300 products per run in your feed settings.
- Preview shows
-: Log previews may hide URL strings as-for display formatting. Ignore the-in preview mode and test 2–3 SKUs to confirm the actual import status. - Geo-blocked or restricted server: The supplier server may block automated requests based on region, IP, or session. Whitelist the Stock Sync IP (
52.20.189.51) and confirm Shopify has public access to the files. - Unsupported endpoints: The field may link to ZIP files, HTML web pages, or token-restricted API endpoints. Request direct, static image file URLs (e.g.,
.jpg,.png) from your supplier.
Recommended Verification Process
- Verify source data: Confirm the source file contains complete, publicly accessible URLs mapped to Product Images. To exclude products without images, configure an incoming-feed filter that requires the image field to be present and non-empty. Check each variant row, because a product may have an image on one size or color row but not another.
- Review other filters and grouping: Keep the image filter together with the required SKU, size, tag, or other filters. If variant grouping is enabled, map Variant group as well as the size and color fields. Empty grouping fields or an empty required field can exclude otherwise valid products.
- Run a sample test: Run a test sync on 2–3 SKUs before a full catalog import.
- Review import logs: Check the feed change log for specific URL retrieval errors or status codes.
- Import or update images safely: For new products, use an Add feed with the image filter enabled. For existing products, create an Update Feed with the product identifier and image URL, map Product Images, and select Skip existing images, import new images. This adds missing images without replacing existing ones. If the missing image is not in the relevant variant row, the update may not add it. Correct the source data or variant grouping first.
Key Rules & Technical Details
- Direct image URLs required: Image URLs must point to direct image files (e.g.,
.jpg,.png), not web pages or preview links. - Public access: Image links must be publicly reachable over
https://without login credentials or FTP authentication. - Server IP whitelisting: If a supplier server blocks automated image downloads, ask them to whitelist Stock Sync's IP address:
52.20.189.51.
Troubleshooting Steps
- Issue: Images are missing after import → Solution: Check the image URLs, mapping, and variant rows for the affected SKU, then run a sample update.
- Issue: Images are duplicated → Solution: Enable Skip existing images, import new images, or use Replace Images together with Skip Existing Images for a clean re-import.
- Issue: Image URLs in one cell are not parsing → Solution: Set the Image Column Separator to
|instead of Auto. - Issue: Images return errors such as HTTP 403 or
Unsupported Media Type→ Solution: Test the direct image URL in a private browser window, ask the supplier to whitelist52.20.189.51, and disable Use image CDN if needed.
Good Articles to Continue
- Product Images Field → Learn every setting of the Product Images field, including separators and replace options.
- How can I resolve issues with product images not importing correctly? → A quick checklist for images that fail to import.
- How do I import images for products successfully? → Step-by-step guidance for importing product images in a feed.
Updated on: 13/11/2026
Thank you!
