Shopify Troubleshooting · Updated October 10, 2026
How to Fix Unsupported Image Format Errors When Uploading to Shopify
An upload error does not always mean you need a different image format. The extension may not match the file, the image may be damaged, or the upload location may have its own restrictions. Check the actual file and Shopify’s current media requirements before converting your product images.
Choose the right converter
For iPhone HEIC/HEIF photos that Shopify or an app will not accept, create a JPG copy. For an existing PNG or JPEG that you want to deliver as WEBP, convert a test copy and confirm your specific Shopify workflow accepts it before replacing assets.
1. Check the actual format, not just the filename
A file named photo.jpg is not necessarily encoded as JPEG. Renaming an extension does not convert the image data. Check file properties or open it in an image editor; if it is HEIC, HEIF, or another unsupported type for that specific uploader, export a real JPG or PNG copy.
2. Convert iPhone HEIC photos to JPG
HEIC is common on iPhones, but support can vary across upload flows, apps, and devices. Use the HEIC to JPG converter to select a HEIC or HEIF file, choose output quality, and download a JPG copy. Keep the original in case you need its full source quality or metadata.
3. Resize or re-export large and damaged files
Check whether the file opens locally and whether it exceeds Shopify’s current size or dimension requirements for the upload location. If it is damaged, re-export it from the source. Resize images to dimensions appropriate for the theme rather than uploading a much larger file than the layout needs. Check Shopify’s current product-media documentation for supported types and limits, which can change.
4. Use WEBP only where your workflow accepts it
WEBP can be useful for web delivery, but do not assume every Shopify importer, theme, feed, or connected marketplace handles the same formats. The PulseTools converter takes PNG or JPEG input and exports WEBP; it does not upload or replace your Shopify media. Convert one copy, test it in the exact product editor or app, and retain a broadly compatible JPG or PNG source when required.
Read the PNG-to-WEBP optimization guide →5. Rule out upload and browser problems
- Retry with a small, known-good JPG or PNG to see whether the issue is file-specific.
- Check your connection, sign in again, and retry in a current browser or private window.
- Disable extensions that may interfere with uploads and check whether Shopify reports a service issue.
- If only one admin section or app rejects the file, consult that workflow’s requirements rather than converting the whole product library.
Keep a source copy and verify the storefront
Store original files separately, compare converted image quality, and confirm the image appears on product, collection, and mobile views after upload. A successful upload does not guarantee the theme is serving the most appropriate size or format; inspect the live page and its image requests separately.