WooCommerce product image size settings, explained

WooCommerce uses three image sizes: 600 px single, 300 px square catalog and 100 px gallery thumbnails. Here is how to set them and what to upload.

By
Picture Optimizer team
Published
Type
How-to

WooCommerce uses three product image sizes: woocommerce_single for the main image on a product page (600 px wide, uncropped by default), woocommerce_thumbnail for shop and category grids (300 px wide, square-cropped) and woocommerce_gallery_thumbnail for the small gallery images (100 × 100 px). You change them in Appearance > Customize > WooCommerce > Product Images. Upload originals of at least 800 × 800 px, in one consistent ratio.

Key takeaways

  • Three sizes, three jobs: single product image, catalog grid, gallery thumbnails.
  • WooCommerce generates these from your upload, so upload large enough and consistent.
  • Blurry images usually mean the theme shows an image bigger than the size generated.
  • After changing sizes, regenerate shop thumbnails.

The three WooCommerce image sizes

Size name

Used for

Default

woocommerce_single

Main image on single product pages

600 px wide, uncropped

woocommerce_thumbnail

Product grids: shop, categories, related products, up-sells, cross-sells

300 px wide, square crop

woocommerce_gallery_thumbnail

Small images below the main image that switch the gallery

100 × 100 px, always square

These sit on top of WordPress's own sizes (thumbnail 150 × 150, medium 300 × 300, medium_large 768 wide and large 1,024 × 1,024 by default), which is why one product photo turns into many files on your server.

Where to change them

Go to Appearance > Customize > WooCommerce > Product Images. There you can set the main image width and the thumbnail width, and choose how thumbnails are cropped:

  • 1:1: every catalog image is a square.
  • Custom: enter a ratio, for example 4:5 for portrait clothing photos.
  • Uncropped: images appear as uploaded, which WooCommerce notes can make grids look uneven.

Some themes set these sizes themselves. WooCommerce's developer documentation explains that themes can override the defaults with filters, and cautions that doing so removes control from the store owner. If you don't see the options, check your theme's documentation.

After changing sizes: regenerate thumbnails

New sizes only apply to images WooCommerce has resized at those dimensions. WooCommerce's developer documentation describes background regeneration after size changes, and its guide to blurry images says to go to WooCommerce > Status > Tools and click Regenerate next to Regenerate shop thumbnails.

How big should your uploads be?

WooCommerce's guide to blurry product images says:

  • the original image should be at least 800 × 800 px for most themes;
  • for sharp images on retina (high-density) screens, set thumbnails to double the size your theme displays.

So if your theme shows catalog images at 300 px, a 600 px thumbnail setting is sharper on high-density screens, and your originals need to be at least that big. In practice, uploading product photos at around 1,600 to 2,048 px on the long side covers zoom and high-density screens without uploading 20+ megapixel camera files. Pick one size and ratio and use them for the whole catalog.

Choosing a ratio for your catalog

Pick one ratio before you shoot, because cropping inconsistent photos afterwards always loses something.

  • 1:1 (square) suits most themes' grids and products of mixed shapes. It's WooCommerce's default for catalog thumbnails.
  • Portrait (for example 4:5 or 3:4) suits clothing and tall products, where a square crop wastes space at the sides. Set it with the Custom cropping option.
  • Uncropped keeps each photo's own shape. It only looks tidy if your photos already share a ratio.

Whatever you choose, leave some space around the product when you shoot, so the crop doesn't cut into it.

Fixing blurry product images

WooCommerce lists two common causes:

  1. Theme styling displays images larger than the size WooCommerce generated, so the browser stretches them.
  2. Uploads or size settings are too small.

The fix is usually: raise the image size settings to match (or double) what the theme displays, make sure originals are large enough, then regenerate shop thumbnails.

A checklist after changing image settings

  1. Note the widths your theme actually displays (inspect an image in the browser to see its rendered size).
  2. Set the catalog thumbnail and single image widths to match, or double them for high-density screens.
  3. Choose the cropping option for your catalog ratio.
  4. Run Regenerate shop thumbnails under WooCommerce > Status > Tools.
  5. Check a category page and a product page on desktop and phone.
  6. Spot-check an older product to confirm its images were regenerated.

Keep product images light

Large uploads are fine for WooCommerce's source files, but each generated size should be compressed sensibly. WordPress 5.8+ accepts WebP and WordPress 6.5+ accepts AVIF if your server supports them, which makes the generated sizes smaller.

For reference, in our sample run a furniture showroom photo, resized to 2,048 px and saved as AVIF, was 338 KB; its 768 px version was 56 KB and its 300 px version 12 KB.

Describe each product image

Every product photo should have alt text that says what is different about that image: color, angle, detail or variant. "Grey leather sectional sofa with matching ottoman, front view" tells a screen reader user much more than "sofa". The W3C's guidance is to convey the meaning in a short phrase or sentence.

Doing it for a whole catalog

Picture Optimizer's e-commerce image optimization resizes, compresses and converts product photos and, from Starter up, writes alt text, titles and file names you review before export. On Starter you can send the results straight to your WordPress Media Library; on Pro, the WordPress plugin, which works with WooCommerce, optimizes the product images already in your library and regenerates thumbnails. See how store owners use it on the e-commerce stores page.

Keep reading

Sources

Questions

Short answers to what people ask about this.

WooCommerce's documentation says originals should be at least 800 × 800 px for most themes, and recommends thumbnails at double the size your theme displays for sharp results on high-density screens. Upload one consistent ratio across your catalog.

How-to · E-commerce product images

Shopify product image size: the numbers that matter

Shopify recommends 2048 × 2048 px for square product images, allows up to 5000 × 5000 px (25 megapixels) and 20 MB, and picks the delivery format for you.