Troubleshooting Image Import Issues
This guide covers the most common reasons why product images fail to import in Stock Sync feeds and how to resolve them.
1. Image URLs return errors (e.g., 403 Forbidden)
If an image URL in your feed cannot be accessed publicly, Stock Sync cannot download it. A common example is when URLs return 403 Forbidden.
How to fix:
- Check the problematic image URLs directly in your browser.
- If they fail to load or require login/permissions, contact your supplier to provide publicly downloadable image links.
2. The feed contains placeholder or invalid images (e.g., white image, “noImage.png”)
If your supplier's feed contains placeholder images, Stock Sync will import them as provided.
To prevent these from being uploaded:
- Open Field Mapping > Image field.
- Click Find and Replace.
- In Find, paste the unwanted image URL (e.g. https://eversellstorage.blob.core.windows.net/eversell-images/noImage.png).
- Leave Replace empty.
This removes the unwanted URL during sync.
3. Image column mapped incorrectly
Images may fail to import if the mapped column contains webpage URLs instead of direct image URLs.
How to fix:
- Ensure the Image field is mapped to a column that contains direct image URLs (usually ending in .jpg, .png, etc.).
- If you mapped the wrong column (such as one containing website links), remap to the correct column like "Product image URL".
4. Incorrect separators when multiple images are in one column
If image URLs are listed but separated incorrectly, Shopify may fail to process them.
How to fix:
- Use commas (,) as separators.
- In Stock Sync, ensure Image Column Separator matches what your feed uses.
5. JMESPath logic fails when a product has only one image
If using JMESPath for XML expressions:
{% assign urls = data | jmespath: "Images.Image[*]" %}{{ urls | join: "," }}
This works for multiple images but may return nothing when only one image exists.
Solution:
- Ensure your expression outputs an array for both single and multiple images.
- Adjust mapping so single image nodes are treated the same as arrays.
6. Media upload failures caused by formatting
Shopify may reject images if formatting is incorrect (such as unexpected spacing).
How to fix:
- Clean the feed to ensure no extra spaces or line breaks in image URLs.
- Use commas as separators for multiple images.
If issues persist, test a few URLs directly in your browser to confirm they resolve correctly.
7. Images that require login, Google Drive access, or FTP are not supported
Only publicly accessible image URLs are supported. If your feed provides protected links, they must be replaced with public ones.
If you continue experiencing problems, share a sample SKU and the related image URL so the issue can be diagnosed further.
Updated on: 03/06/2026
Thank you!