Shopify images not uploading or the upload fails
By Michael Broadbridge. Last checked 14 November 2026 on Shopify admin.
Short answer
Shopify images must be under 20 MB and, for product images, no more than 25 megapixels, which is 5000 by 5000 pixels. A file under 20 MB can still be rejected for its pixel size, so resize it to around 4000 by 4000 pixels. Save it as JPEG or PNG and upload again.
Symptoms
You may see one of these messages:
You need to upload a file that is 20 MB or smaller
Processing error
The uploaded image is corrupt and cannot be processed. Please try a different image.
Aspect ratio must be between 100:1 and 1:100.
There are errors with this collection: Error updating collection with this image.
This file couldn't be added: You can only add up to 250 media per product.
Files failed. There is a limit of 200 files per upload. Try again with fewer than 200 files.
Media processing failed
Invalid URL
File extension doesn't match the format of the file
Files failed. You've reached the file storage limit for your plan.
- The upload stops with a message that the file is too large, even though it is under 20 MB.
- An upload ends with Processing error or a message that the image is corrupt.
- A banner such as Uploading 1 remaining stays on screen.
- Add from URL fails with a Google Drive or Dropbox link.
- An image uploads to a product but not as a collection image.
Causes, most likely first
Too many pixels
Shopify limits resolution as well as file size. Product and collection images can be up to 25 megapixels, and a high resolution photo can go over that while staying under 20 MB.
The file was exported in a way Shopify cannot convert
Processing error means the file reached Shopify but could not be converted. Shopify says this is usually down to how the file was encoded or exported, not its size or format.
The format, or a renamed file
Shopify accepts JPEG, PNG, GIF, HEIC and WebP, and product images also accept TIFF, BMP and SVG. Collection images do not support WebP. A file renamed to a different extension by hand no longer matches its real format.
A sharing link instead of the file
Add from URL needs a link to the file itself. A Google Drive or Dropbox sharing link opens a preview page, so the upload fails.
An app with a lower limit
An app or third-party image service can have its own size limit, lower than Shopify’s. If an image uploads in the Shopify admin but fails inside an app, the app’s limit is the likely cause.
How to fix it
Check the file
- Check the file size. It must be under 20 MB.
- Work out the megapixels: width times height, divided by 1,000,000. An image of 4900 by 6930 pixels is 33.9 megapixels, which is over the limit.
- If it is over 25 megapixels, or over 20 megapixels for an image added in the theme editor, resize it. Shopify gives the example of resizing 5000 by 5000 pixels to 4000 by 4000, which is 16 megapixels.
- Check the shape. Images must have an aspect ratio between 100:1 and 1:100, so a very long, thin banner can fail.
Shopify does not need images compressed before upload, but resizing them to roughly the size they display at keeps pages fast.
Export a fresh copy
- Open the image in an image editor or your computer’s photo app and export a new copy as JPEG or PNG.
- If many files fail the same way, change the export settings in the software that made them.
- Keep the real file extension. Do not rename a file to change its format.
- Check that the file name does not begin with a full stop.
Upload it again in the right place
- For a product, open the product and click Upload new in the Media section, or drag the file in.Menu:
Products - For other images, click Upload files. You can upload up to 200 files at a time.Menu:
Content > Files - For Add from URL, download the file to your computer first, then upload it.
- For a collection image, use a format other than WebP, such as JPEG or PNG.
If an upload seems stuck
- Check Files and the product’s Media section. If the image is there, the upload worked, even if a banner said otherwise.Menu:
Content > Files - If it is not there, wait. Stuck uploads are removed automatically within 2 hours, and then you can upload again.
- Try a private browser window, another browser or another connection, and turn off any VPN.
- If the banner is still there after 2 hours, contact Shopify Support.
If that didn’t work
The upload fails inside an app
Apps that take uploads, such as product personalisers, may store images with their own service. Check the app’s upload limit in its help pages, and contact the developer if a file within that limit still fails.
The product or store is full
A product can hold up to 250 media items, and this cannot be raised. Plans also have a storage limit. Removing an image from a product does not free storage until you delete it in Content, then Files.
Images missing after a CSV import
A product CSV import can finish and still skip images without saying so. Check the products afterwards and add any missing images.
When to get help
Contact Shopify Support if an upload is stuck for more than 2 hours, if Shopify says you have reached your storage limit but the store holds little media, or if a file that meets every limit still fails. Have the exact error, the file name, format and size, and where you uploaded it ready. If the failure only happens inside an app, the app developer needs to look at it.
What a developer would check
- Whether the failure happens in the Shopify admin, the theme editor or inside an app.
- The app or image service’s own upload limit and the errors it returns.
- Image dimensions, format and export settings for the failing files.
- Image addresses typed into theme code that still point at old versions.
Describe the problem in your own words and WebFixed gives you an instant fixed quote. Nothing is charged until you accept it.
Related questions
- What is the maximum image size on Shopify?
- Under 20 MB. Product, collection and Files images can be up to 25 megapixels, such as 5000 by 5000 pixels. Shopify’s theme image help gives 20 megapixels, so staying under that, such as 4000 by 4000 pixels, works everywhere.
- Does Shopify accept HEIC photos from an iPhone?
- Yes. HEIC is a supported format for product images and files. TIFF and BMP are also accepted for product images and are converted to JPEG or PNG on upload.
- I replaced an image but the old one still shows. Why?
- Shopify gives the new file a new version in its address. Pages Shopify builds pick it up, but an address typed by hand into theme code, a description or an email still points at the old file. Add images through the media uploader instead.
Written by Michael Broadbridge, Founder of Webgro. First published 14 November 2026. Last checked 14 November 2026 on Shopify admin.