Troubleshooting · Troubleshooting
How to Fix Blurry Product Images in WooCommerce
Short answer
Blurry WooCommerce product images usually come from uploads that are smaller than the size your theme displays, or from image widths set too low. Upload originals of at least 800x800 pixels, set the main image and thumbnail widths in Appearance > Customize > WooCommerce > Product Images to match or exceed your theme's largest display size, then regenerate thumbnails at WooCommerce > Status > Tools. Check the result in a private browser window.
Key takeaways
- WooCommerce recommends uploads of at least 800x800 pixels for product images.
- Images are resized to the widths in Appearance > Customize > WooCommerce > Product Images, so low settings stretch small files.
- Changing image settings does not update old images until you regenerate thumbnails.
- Your theme sets the largest display size, and Storefront shows the main image at 800x800 pixels.
- Retina screens need images at twice the displayed size to look sharp.
Why are my WooCommerce product images blurry?
Your images are blurry because the file is smaller than the size your theme displays, or your WooCommerce image widths are set too low.
WooCommerce creates three image types from every upload, and each one shows in a different place. WooCommerce's guide to product images lists them as the single product image, the catalog image, and the product thumbnail.
If any of those sizes is smaller than the space it fills, the browser stretches it and the photo looks soft.
Heavy compression can also soften a photo, so check your image optimisation plugin if the original file looks sharp. A blurry original stays blurry at every size, so fix the source file first.
What size should I upload for WooCommerce product images?
Upload product images of at least 800x800 pixels, and larger for products with fine detail.
WooCommerce recommends 800x800 pixels as the minimum because that size works as the single product image, the catalog image, and the thumbnail. Larger images are better for products with fine detail, such as jewellery or fabric, where shoppers zoom in to inspect the item.
Square uploads suit most stores because catalog thumbnails crop to a square by default. Leave even padding around the product so a square crop does not cut off an edge. If you sell tall or wide items, use one consistent ratio across the catalog so the grid stays neat.
Check the real dimensions before you upload. Open the file in your Media Library and read the dimensions in the Attachment Details panel. WooCommerce's blurry image guide says the original should be at least 800x800 pixels for most themes, and anything smaller should be replaced with a higher-resolution version.
How do I change WooCommerce image sizes?
Go to Appearance > Customize > WooCommerce > Product Images and set the main image width and thumbnail width to match or exceed your theme's largest display size.
The panel has three controls: Main image width, Thumbnail width, and Thumbnail cropping. Set the main image width to match or exceed the largest size your theme renders, then click Publish. WooCommerce's blurry image guide gives this as the core fix after replacing small originals.
Thumbnail cropping offers 1:1 square, a custom ratio, or Uncropped. The 1:1 square default keeps catalog grids tidy, while Uncropped keeps each image's own ratio and can leave uneven rows. Pick the option that fits your product shapes, then check the shop page.
Some themes set their own image widths and hide the matching Customizer controls. WooCommerce's theme image width guide explains that theme values take precedence over the saved width settings. If the panel is missing, check your theme's documentation. Block themes may hide the Customize menu, so open the Customizer directly at yourdomain.com/wp-admin/customize.php.
For help with the wider topic of image dimensions, see our guide on how to fix “Properly Size Images” in WordPress.
Why must I regenerate thumbnails after changing image sizes?
Changing image settings only affects new uploads, so you must regenerate thumbnails before old images use the new sizes.
WooCommerce generates the display sizes when you upload a file, and it does not rebuild them when you change a setting. WooCommerce's blurry image guide states this plainly: any time you activate a new theme or change image dimension settings, you need to regenerate previously created thumbnails.
Go to WooCommerce > Status > Tools and click Regenerate next to Regenerate shop thumbnails. Give it time on a large catalog, since every image must be rebuilt. Do not navigate away until it finishes.
If the built-in tool does not clear old sizes, the Force Regenerate Thumbnails plugin deletes old image sizes and rebuilds them from the Tools menu or from Media Library bulk actions. Keep your original uploads, since regeneration needs the full-size file.
How do I find the image size my theme displays?
Open your shop page, right-click a product image, choose Inspect, and read the rendered dimensions in your browser's developer tools.
Your theme decides the largest size, so guessing wastes time. WooCommerce's blurry image guide walks through this check: inspect the shop page for the largest catalog image, then inspect a product page for the single product image and the gallery thumbnail.
In the Storefront theme, the largest catalog image renders at 324x324 pixels, the single product image at 800x800 pixels, and the gallery thumbnail at 46x46 pixels, according to WooCommerce's blurry image guide. The 800x800 single image is needed for the zoom effect, even though it does not display that large on screen.
Repeat the check on a category page and on a product page, since different templates can use different sizes. Write the numbers down, then set your widths to match or exceed the largest one you found.
| Image type | Where it appears | Storefront example size | Setting that controls it |
|---|---|---|---|
| Single product image | Main image on the product page | 800x800 pixels | Main image width |
| Catalog image | Shop, category, related products | 324x324 pixels | Thumbnail width |
| Product thumbnail | Cart, widgets, gallery thumbnails | 46x46 pixels | Gallery thumbnail size |
How do I fix blurry images on retina screens?
Set your image widths to double the size your theme renders, so high-density screens have enough pixels.
Retina displays hold twice as many pixels as standard screens, or more. Wikipedia's Retina display article explains the pixel density behind the term. WooCommerce's blurry image guide gives a clear rule: if your theme renders images at 80x80 pixels, set the dimension to 160x160 pixels.
This means your originals must be larger too. A 800x800 upload cannot fill a 1600-pixel slot without stretching, so plan for double size from the start. If your theme shows a main image at 800 pixels wide, aim for originals around 1600 pixels wide for sharp results on phones and laptops with dense screens.
Doubling sizes can slow page loads because larger images take longer to download. WooCommerce's blurry image guide advises checking your analytics to see which devices and screen sizes most customers use before making the change. Serve modern formats as well, as explained in our guide on how to serve WebP and AVIF images in WordPress.
Why are only some product images blurry?
Some images are blurry because only some of them are too small, cropped badly, or served from an old thumbnail size.
Check the affected images one by one in the Media Library. A supplier photo at 500 pixels wide will look soft next to a 2000-pixel studio shot, even with the same settings. Replace the small ones first.
Gallery thumbnails are the most common partial case. They are tiny, so a low-resolution original shows its flaws there first. Variation images can also differ, since each variation can carry its own photo with its own dimensions.
A caching plugin can serve an old, small version after you fix the settings. Clear the cache and check the page in a private window.
If the problem started after a theme change, the old thumbnails were built for the old theme, so regenerate them. For cache settings that suit a store, see our LiteSpeed Cache settings for WooCommerce.
If an image shows at all, it is not a missing-file problem. When images fail to appear instead, our guide on how to fix images not showing in WordPress covers that case.
How do I check the fix worked?
Open the shop page and a product page in a private browser window, then inspect the image to confirm the browser loads the new size.
Log out first, since logged-in views can bypass the cache and hide the problem. Look at the main image, the catalog grid, and the gallery thumbnails. Zoom the main image to confirm the detail holds up.
Use Inspect to check the loaded file. The image URL should point to the new size, such as 800x800, and the rendered size should match what your theme needs. If the old size still loads, purge the cache and regenerate thumbnails again.
Check on a phone too, since most shoppers browse on mobile. If the images look sharp on desktop and on a phone, the fix is done. Record the widths you set, so a future theme change does not undo them.
What mistakes should you avoid?
Most blurry image problems come from skipping the regenerate step or from uploading files that are too small.
- Uploading images smaller than 800x800 pixels and hoping the settings will sharpen them. Settings cannot add detail that the file lacks.
- Changing image widths and skipping the regenerate step, so old images keep the old sizes.
- Setting the main image width far above the theme's display size, which slows the shop without improving sharpness.
- Deleting original uploads after resizing, which leaves nothing to regenerate from later.
- Editing the live theme's functions.php to set image widths without a child theme or a backup, since a theme update wipes the change.
- Judging the fix while logged in, when the cache may show you a different page than shoppers see.
Frequently asked questions
What is the best image size for WooCommerce products?
Upload at least 800x800 pixels. That size covers the main product image, the catalog image, and the thumbnail on most themes. Use larger files, around 1600 pixels wide, if your shoppers use retina screens or zoom into fine detail.
Why are my WooCommerce images blurry after changing the theme?
A new theme often uses different image sizes, and old thumbnails were built for the old theme. Go to WooCommerce > Status > Tools and run Regenerate shop thumbnails so every image is rebuilt at the new sizes.
Where are WooCommerce product image settings?
On classic themes, go to Appearance > Customize > WooCommerce > Product Images. You will find Main image width, Thumbnail width, and Thumbnail cropping. Block themes may hide the Customize menu, so open the Customizer at yourdomain.com/wp-admin/customize.php.
Does regenerating thumbnails delete my original images?
No. The built-in tool rebuilds the display sizes from your originals and leaves the original files in the Media Library. Keep those originals, because regeneration cannot work without them.
Can a plugin fix blurry WooCommerce images?
A plugin can rebuild thumbnails, such as Force Regenerate Thumbnails, but it cannot sharpen a small original. Fix the source file size and the width settings first, then use a plugin only to rebuild the sizes.
Sources
- Fixing blurry product images WooCommerce
- Adding Product Images and Galleries WooCommerce
- Set product image widths in a WooCommerce theme WooCommerce
- Force Regenerate Thumbnails WordPress.org
- Featured Images and Post Thumbnails WordPress Developer Resources
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
