Quick Answer
If your Shopify product images are not showing, the cause is usually one of these:
Β·Β Β Β Β Β Β Β Β The image file exceeds Shopifyβs upload limits (over 20 MB or 20 megapixels).
Β·Β Β Β Β Β Β Β Β Your theme or a recently installed app is hiding the image.
Β·Β Β Β Β Β Β Β Β The product is not available on the Online Store channel.
Β·Β Β Β Β Β Β Β Β The image is still processing, or a browser or CDN cache is showing old data.
Test with a default theme first. It tells you in two minutes whether the problem is your theme or your images.
If you manage a Shopify store, few things feel as urgent as a product page with no pictures. Shoppers will not buy what they cannot see. This guide is for store owners, not developers. Each fix uses the Shopify admin and plain language.
Why Shopify Product Images Stop Showing
Product images can fail to display for a few reasons:
Β·Β Β Β Β Β Β Β Β The file itself: it is too large, in an unsupported format, or failed to upload.
Β·Β Β Β Β Β Β Β Β The theme: the code (Liquid, the template language themes use) points to the wrong image or a placeholder.
Β·Β Β Β Β Β Β Β Β Apps: a lazy-loading, image-optimization or page-builder app is interfering.
Β·Β Β Β Β Β Β Β Β Settings: the product is not published to your store, or an image is not assigned correctly.
Β·Β Β Β Β Β Β Β Β Caching: your browser or network is showing an old version of the page.
First, find out where the image is missing. The fix depends on it.
Β·Β Β Β Β Β Β Β Β Only on the product page? Start with Fixes 1, 2 and 6.
Β·Β Β Β Β Β Β Β Β Only on collection or home pages? Start with Fixes 4, 5 and 6.
Β·Β Β Β Β Β Β Β Β Only in cart, checkout or orders? Go to Fix 8.
Β·Β Β Β Β Β Β Β Β Only on some products? Start with Fixes 1, 3 and 7.
Fix 1: Check the Images in Your Shopify Admin
Start with the source.
1. Go to Products and open the affected product.
2. Look at the Media section. Do the images appear here?
3. If an image shows a gray box, an error or a spinner, delete it and upload it again.
4. Click Save.
How to confirm it worked: open the product in your store, then refresh the page.
If the image does not appear in the admin, the problem is the file, not your theme. Move on to Fix 2.
Fix 2: Make Sure the File Meets Shopifyβs Requirements
Shopifyβs help center lists limits for uploaded images:
Β·Β Β Β Β Β Β Β Β File size: a maximum of 20 MB per image.
Β·Β Β Β Β Β Β Β Β Resolution: a maximum of 20 megapixels.
Steps:
1. Check the original file size on your computer.
2. If it is too large, compress or resize it. A square image of 2048 Γ 2048 pixels is a common, well-supported size.
3. Save it as a JPEG or PNG.
4. Upload it again.
Very large files can also slow your store, which causes its own display problems. Smaller files are better for speed.
Source: Shopify Help Center β Uploading and managing files
Fix 3: Confirm the Product Is Active and Available Online
An image cannot show on a store where the product itself is not published.
1. Open the product in Products.
2. Check that Status is Active, not Draft or Archived.
3. Find Sales channels and apps (usually on the right side of the page) and make sure Online Store is included.
4. Click Save.
How to confirm it worked: open the productβs public link in a private (incognito) browser window.
Fix 4: Test with a Default Shopify Theme
This is the fastest way to separate a theme problem from an image problem.
1. Go to Online Store > Themes.
2. Find a free theme such as Dawn in the Theme library and add it. You do not have to publish it.
3. Click Customize or Preview on that theme and open the same product.
What the result means:
Β·Β Β Β Β Β Β Β Β Images show in the default theme: the problem is in your current theme or one of your apps. Continue to Fixes 5 and 6.
Β·Β Β Β Β Β Β Β Β Images still missing: the problem is the images or product settings. Go back to Fixes 1 to 3, or contact Shopify Support.
Fix 5: Check Your Theme Settings and Recent Changes
Think about what changed just before the images disappeared. Common triggers:
Β·Β Β Β Β Β Β Β Β You added or removed a section in the theme editor.
Β·Β Β Β Β Β Β Β Β You changed the product image aspect ratio or media settings.
Β·Β Β Β Β Β Β Β Β You edited theme code.
Β·Β Β Β Β Β Β Β Β You updated or switched your theme.
Steps:
1. Go to Online Store > Themes > Customize.
2. Open a Product template from the page selector at the top.
3. Check the Product information or Media section. Make sure it is visible and not hidden.
4. Look at the image or media settings (such as gallery layout or image ratio) and try the defaults.
5. If you edited code, restore an earlier version. In Online Store > Themes, open the themeβs β¦ menu and look for Edit code or the version history.
Tip: always duplicate your theme before changing code. A copy takes seconds and saves hours.
Fix 6: Disable Apps That Touch Images
Apps that change how images load can cause blank spaces. These include:
Β·Β Β Β Β Β Β Β Β Lazy loading and speed optimization apps
Β·Β Β Β Β Β Β Β Β Image compression apps
Β·Β Β Β Β Β Β Β Β Page builders and product gallery apps
Β·Β Β Β Β Β Β Β Β Review or swatch apps that edit the product gallery
Steps:
1. Note any app you installed or changed recently.
2. Turn off its app embed in Online Store > Themes > Customize > App embeds.
3. Reload the product page and check the images.
4. If the images return, contact the appβs support or replace the app.
Fix 7: Check Variant Images and Image Assignment
If images are missing only after you choose a variant (a size or color), the variant image is the problem.
1. Open the product and click the variant.
2. Check that an image is assigned to that variant.
3. Make sure the image file still exists in the productβs Media.
4. Save and test again.
Related: Shopify variant image not changing? How to fix it
Fix 8: Images Missing in the Cart, Orders or Emails
If images show on product pages but not in the cart or order pages:
Β·Β Β Β Β Β Β Β Β Newly added product: wait a few minutes and check again.
Β·Β Β Β Β Β Β Β Β Changed image: re-save the product so the image link refreshes.
Β·Β Β Β Β Β Β Β Β Old orders: Shopify does not always update images on past orders. Check a new test order.
Β·Β Β Β Β Β Β Β Β Custom theme code: cart templates sometimes use code that does not find the image. A developer can fix this quickly.
Fix 9: Clear Caches and Check Your Connection
If the page works for other people but not for you:
Β·Β Β Β Β Β Β Β Β Reload the page with a hard refresh (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac).
Β·Β Β Β Β Β Β Β Β Try an incognito window.
Β·Β Β Β Β Β Β Β Β Try a different browser. Some report images failing in one browser only.
Β·Β Β Β Β Β Β Β Β Turn off ad blockers or security extensions for your store.
Β·Β Β Β Β Β Β Β Β Try a different device or network.
Β·Β Β Β Β Β Β Β Β Wait a little. Newly uploaded images can take a moment to process.
If only you see the problem, your store is probably fine.
When to Call a Developer
Get expert help if:
Β·Β Β Β Β Β Β Β Β Images work in a default theme but not in yours, and you do not want to edit theme code.
Β·Β Β Β Β Β Β Β Β Only some product pages or templates are affected.
Β·Β Β Β Β Β Β Β Β You have custom code, a page builder or several apps and cannot find the cause.
Β·Β Β Β Β Β Β Β Β You are running ads and every hour counts.
Ecomheroes has been fixing Shopify stores since 2018. You can get a fixed-price Shopify task from $59 or ask about theme customization. If your images are slow as well as broken, the Shopify SEO and speed service covers both.
Links:
Β·Β Β Β Β Β Β Β Β Fixed-price Shopify tasks
Β·Β Β Β Β Β Β Β Β Theme customization
Β·Β Β Β Β Β Β Β Β Shopify SEO and speed service
FAQ
Why are my Shopify product images not showing on the collection page?
The usual causes are a theme setting, an app that changes image loading, or a product missing the Online Store channel. Run the default theme test in Fix 4.
Why do images show on the product page but not on the home page?
Different sections use different theme code. Check the featured product or collection section settings in the theme editor, then test with a default theme.
What is the maximum image size on Shopify?
Shopify allows images up to 20 MB and 20 megapixels. Smaller files load faster.
Why are my product images only missing on my phone?
Try a hard refresh and a different browser, and turn off extensions. Also check whether a recent app or theme change affects mobile.
Can a recent theme update make images disappear?
Yes. Updates and edits to sections can change how media displays. Restore a previous version or ask a developer to check.
Conclusion
Most missing-image problems come down to the file, the product settings, the theme or an app. Work through the checklist in order, and use the default theme test to save time. If you are stuck, contact Ecomheroes and we will find the cause.