Troubleshooting Shopify Product Image Import Issues

This article summarizes common causes and solutions for product image import issues when using Stock Sync with Shopify.

1. Image URLs must be publicly accessible

Shopify and Stock Sync can only import images from URLs that are publicly downloadable. Any image URL served behind a CDN restriction, firewall, login, or blocked request will fail to import.

If images do not load:

• Ensure the image URL can be opened in a browser without authentication.
• Ask the supplier to make the URLs publicly accessible.

2. Characters in image URLs

Some feeds include filenames containing characters such as +, -, or .. In certain cases, the image field may clean or strip these characters, causing URLs to become invalid.

If this happens:

• Disable URL cleaning using the url_unescape setting in the image field.
• Re‑import the products after adjusting this setting.

3. Correct field mapping for image filenames

If the feed provides both a base image URL and a separate image filename list, ensure the mapping is correct:

• Use the Product Images field to map the filenames. Then use URL Prefix in the smart settings to add URL prefix(i.e. domain of the image) to every image links.

Incorrect mapping can cause image import failures.

Additionally, ensure that the mapped column contains direct image URLs, not links to webpages or product pages. Shopify cannot extract images from standard webpage URLs.

4. Supplier server errors (Bad Gateway 502)

When Shopify fetches images directly from the supplier server, high traffic or request limits may cause errors such as:

Unsuccessful HTTP request 502, reason: Bad Gateway

This means the supplier’s server cannot handle the volume of image requests. Contact the supplier to resolve server‑side limits.

5. Shopify CDN upload is not supported

Stock Sync does not support downloading external images and re‑uploading them to Shopify's CDN before attaching them to products.

Images must be imported directly from external URLs provided in the feed.

6. Partial or slow image processing during large imports

When executing large product imports:

• Shopify may take several hours to process all media.
• Only the first batch of images may appear initially.

If needed, run a dedicated image‑only Update feed after waiting 12–24 hours.

7. Handling feeds with many products missing images

If only some products successfully import images:

• Try importing in smaller batches using filters.
• Split large feeds into multiple segments.

This helps isolate and bypass timeouts or server limits.

8. Single‑image vs multi‑image fields in templated feeds

Some templating logic only outputs image URLs when multiple images exist. When a product has only one image, the field may return nothing.

Ensure the field handles both cases using appropriate logic so a single image URL is returned normally.

9. Incompatible or unstable supplier image URLs

Some supplier image URLs are not compatible with Shopify. When this happens, using a CDN or proxy image URL through Stock Sync often resolves the issue.

10. Shopify media limit reached

Shopify allows a maximum of 250 media items per product. If a product is near this limit, additional images will fail to upload. Remove unused media before retrying.

11. Image hosting blocked by security services (Cloudflare)

If Shopify displays errors such as "Media processing failed" when attempting to load external image URLs, the hosting server may be blocking automated requests. This often occurs when Cloudflare or similar services trigger a security challenge.

To resolve:

• Whitelist Shopify's user‑agent or IP ranges in your security/CDN settings, or
• Host the images on a server that allows automated downloads.

If issues persist, testing with sample SKUs and running imports in small batches can help identify whether the problem lies in the feed, mapping, or the source server.

Updated on: 18/06/2026