1. Documentation /
  2. Fixing Blurry Product Images

Fixing Blurry Product Images

The majority of blurry image incidents are caused by theme styling, meaning the design of the theme has image dimensions in pixels that may not play nicely with WooCommerce.

Anytime a new theme is activated or image dimension settings are changed, old thumbnails need to be regenerated under WooCommerce > Settings > Status > Tools > Regenerate Thumbnails.

Update as of WooCommerce 3.3

↑ Back to top

As of WooCommerce version 3.3 making themes compatible with WooCommerce and improvements to image size rendering and cropping are supported. These new features mean that:

  • Blurry images caused by theme incompatibility or overriding code should no longer occur.
  • Store owners can control width and height of their main images.
  • Thumbnail resizing can be done automatically or manually.
  • Images shown to customers always look great by default, so your products keep selling themselves!

To learn how to use these new features, go to: Managing Products and Adding Product Images and Galleries.

Other solutions

↑ Back to top

We recommend updating to the latest version to take advantage of the features described above.

If, for some reason your blurry images issue continues, it could be due to:

  • Your image size settings are too small.
  • Original images need to be of a higher resolution.

To solve this:

  • Your image dimensions should match or be higher than those of your theme.
  • Original images you upload should be at least 800 x 800px or higher to work for most themes.

We show you how to find the max image size your theme wants in the video and below.

Image types

  • Single Product Image: Largest image on the individual product details page and refers to the main/featured image.
  • Catalog Images: Medium-sized image used in product loops, such as the Shop page, Product Category pages, Related products, Up-sells, and Cross-sells.
  • Product Thumbnail Images: Smallest image commonly used in the Cart, Widgets and (optional) Gallery images underneath the Single Product Image.

Standard image dimensions

↑ Back to top

As of WooCommerce version 3.3, Product Image settings can be found under the Customizer, in WooCommerce > Product Images. The image below is what is looks like by default in a theme like Storefront Theme, but other themes might change or add additional options that

The images you upload are resized to match the values you input. For example, if your settings are 100×100 and you upload a 300×600 image it is resized to 100×200. You can also choose to ‘hard crop’ your images, which forces them to be the size specified in the settings, regardless of the raw image you upload, so they’re cropped rather than distorted in scale.

Note: If you change settings after uploading product imagery, you might need to regenerate thumbnails within WordPress for the changes to apply. Head to WooCommerce > Status > Tools > Regenerate shop thumbnails, and click the Regenerate button next to it.

Find theme’s product image dimensions

The theme you chose delegates the max size an image will be, so you need to know the dimensions in which it renders them to set those in WooCommerce.

Catalog Images

Determine where your theme renders catalog thumbnails the largest. In some cases, this is the shop page; in the Storefront Theme, it is in the related products loop.

With the developer tools enabled in your browser of choice, you can right-click the image and select “Inspect” or “Inspect Element”. This will tell you the image dimensions. Make a note of this as we need to use them later.

In Storefront (above), the largest catalog images are rendered at 324 x 324px.

Single Product Image

Repeat the process for the single product image — the largest image on a product page.

In Storefront, the largest Single Product Image is 800 x 800px (although not visibly rendered at that size, it is used and required for the zoom effect)

Product Thumbnail

↑ Back to top

The smallest is likely the thumbnail in the product gallery. Repeat the inspection process to get the dimensions.

In Storefront, it renders at 46 x 46px.

Adjust image dimensions and regenerate thumbnails

↑ Back to top

Now that all thumbnail image sizes for our specific theme are known, we can add images that exceed the largest dimensions to WooCommerce to ensure that future image sizes will be this size or larger.

Any new product images that are uploaded will now have thumbnails in these settings, and should appear without distortion or blurriness.

Note: Saving changes does not automatically update all previously uploaded product imagery. To update old images, WordPress needs to regenerate the thumbnails. Head to WooCommerce > Status > Tools > Regenerate shop thumbnails, and click the Regenerate button next to it.

Retina support

↑ Back to top

HiDPI displays commonly known as retina displays contain twice as many pixels, or more, than older displays. For pixel perfect imagery on retina displays, set your thumbnails to be double the size rendered by the theme. For example, if a theme renders images at 80 x 80px  you want them to be 160 x 160px.

This can impact performance, as larger images take longer to load. This is a personal preference, and you should consult your analytics before deciding. Your stats should tell you what devices and screen sizes the majority of your customers use.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment