Articles on: Frequently Asked Questions (FAQ)

Understanding "Media Upload Failed – Image: Media Processing Failed" Error in Shopify

When syncing products to Shopify via Stock Sync, you may encounter the error message:


"Media upload failed – Image: Media processing failed"


This error indicates that Shopify's servers are unable to retrieve and process the image from the URL provided in your feed. The issue occurs after Stock Sync successfully sends the image URL to Shopify, but Shopify itself cannot download the image.



Why This Error Occurs


1. Image URLs Require Authentication


The most common cause is that the image URLs are not publicly accessible. This includes:

  • URLs hosted on platforms like Files.com, Dropbox, or OneDrive that require login credentials
  • Password-protected directories or servers
  • Standard Google Drive links (not direct download links)
  • CDN-restricted URLs that require authentication tokens


Shopify requires all image URLs to be publicly accessible without any authentication.



2. Security Services Blocking Shopify's Requests


Platforms like Cloudflare, firewall rules, or DDoS protection services may block Shopify's automated image download requests, mistaking them for bot traffic. When this happens, Shopify cannot retrieve the image even though the URL works in a browser.


Important: Whitelisting Stock Sync's server IP (52.20.189.51) alone does not solve this issue. Shopify's own servers must be able to access the image URLs directly.



3. Server or Hosting Issues


  • The supplier's server is temporarily overloaded or returning errors
  • Server timeout during bulk image syncing
  • Image hosting service is down or experiencing issues
  • Rate limiting on the image host preventing bulk downloads



4. URL Format Problems


  • Missing protocol prefix (e.g., URLs starting with // instead of https://)
  • Invalid characters in the URL (such as | symbol)
  • Incorrectly formatted URLs that Shopify cannot parse



How to Verify the Issue


You can confirm this is a Shopify-side access issue by:


  1. Copy the image URL from your feed
  2. Open Shopify admin and navigate to a product
  3. Try to add the image URL directly in Shopify's product image section
  4. If you see "Media processing failed" in Shopify admin, this confirms Shopify cannot access the URL



Solutions


Solution 1: Use Publicly Accessible Image URLs


Request your supplier to:

  • Host images on a publicly accessible server or CDN
  • Generate public URLs (no authentication required)
  • Remove password protection or login requirements
  • For Files.com: Generate public share links instead of authenticated URLs


Solution 2: Adjust Security Settings


If your images are hosted behind Cloudflare or similar security services:

  • Whitelist Shopify's user-agent and IP addresses
  • Temporarily disable bot protection for image URLs
  • Create a security rule exception for image directories
  • Ensure CORS settings allow Shopify to access the images


Solution 3: Use CDN/Proxy URLs


Stock Sync offers a CDN/proxy feature that can route images through an alternative path to bypass Shopify's download restrictions. This can resolve compatibility issues with certain image hosting services.


Solution 4: Re-host Images


If your supplier cannot provide publicly accessible URLs:

  • Download the images manually
  • Upload them to a public CDN or storage service (Amazon S3, Cloudinary, etc.)
  • Update your feed to reference the new public URLs



What About Whitelisting Stock Sync's Server IP?


Stock Sync's server IP address is 52.20.189.51.


Whitelisting this IP allows Stock Sync to:

  • Access your FTP/SFTP server to download product feeds
  • Retrieve data from protected sources


However, whitelisting Stock Sync's IP does not solve the "Media processing failed" error because:

  • Stock Sync doesn't download images; it passes the URLs to Shopify
  • Shopify's servers need direct access to download the images
  • The error occurs when Shopify (not Stock Sync) cannot access the image URL



Testing Recommendations


  1. Test image URLs in an incognito/private browser window to ensure they're publicly accessible
  2. Verify URLs work when pasted directly into Shopify admin
  3. Start with a small batch of 3-5 products before syncing your full catalog
  4. Check that URLs include https:// protocol and valid file extensions



Key Takeaway


The "Media processing failed" error means Shopify cannot access your image URLs. Stock Sync successfully delivers the URLs to Shopify, but Shopify's servers are blocked from downloading them.


The solution is to ensure image URLs are publicly accessible without authentication, or adjust security settings to allow Shopify's servers to access them.


If you continue experiencing issues after verifying your image URLs are public and accessible, please contact Stock Sync support with sample image URLs for further investigation.

Updated on: 04/08/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!