Ecom Image OptimizerWooCommerce Image Sizes
What the three WooCommerce image settings actually control.
Last updated
WooCommerce registers three image sizes and every theme draws from them: `woocommerce_single` for the main product image, `woocommerce_thumbnail` for the shop and category grids, and `woocommerce_gallery_thumbnail` for the strip under the main image. Out of the box these default to 600 px wide, 300 px square-cropped and 100 × 100 px respectively.
The number that actually matters is the one WooCommerce never asks you for: the size of the file you upload. Every registered size is generated from that master image, so a 600 px upload can never produce a sharp 600 px single image on a retina screen. Upload large, let WooCommerce cut it down.
This is also why product images go blurry after a theme switch. The new theme requests different dimensions, but your existing files were already cropped to the old ones, so you have to regenerate thumbnails before anything changes.
WooCommerce image requirements
| Single product image | 600 px wide by default, uncropped |
|---|---|
| Catalog / shop grid | 300 px, square-cropped by default |
| Gallery thumbnail | 100 × 100 px, always square-cropped |
| Recommended upload | 800 × 800 px minimum; 1500 px+ for zoom |
| Where to change | Appearance → Customize → WooCommerce → Product Images |
| After changing | Publish, then regenerate thumbnails |
Source: WooCommerce: Image sizing for theme developers, WooCommerce: Adding product images and galleries
How to do it
- 1Open the bulk resizer and add your product photos.
- 2Set both sides to 1500 px with "Fit inside box" so nothing is cropped unexpectedly.
- 3Export as WebP, or JPEG if your theme or CDN does not handle WebP.
- 4Upload to WooCommerce, then regenerate thumbnails so every registered size is rebuilt.
Frequently asked questions
What size should WooCommerce product images be?
Upload at least 800 × 800 px; 1500 px square is a better default because WooCommerce generates every smaller size from your upload and retina screens request 2× the display size. The displayed sizes themselves default to 600 px (single), 300 px (catalog) and 100 px (gallery thumbnail).
Why are my WooCommerce images blurry?
Almost always one of two causes: the uploaded file is smaller than the size the theme displays, or you changed the image settings without regenerating thumbnails. Existing images keep their old crops until they are rebuilt.
How do I regenerate WooCommerce thumbnails?
WooCommerce queues a regeneration automatically when you publish new size settings in the Customizer. For a forced rebuild, the Regenerate Thumbnails plugin re-cuts every registered size from the original uploads.
Should WooCommerce product images be square?
Square is the safest choice because the catalog and gallery thumbnail sizes are square-cropped by default. Mixed aspect ratios in one grid produce uneven cards unless your theme handles them explicitly.
Does WooCommerce support WebP?
WordPress has supported WebP uploads since 5.8, so WooCommerce inherits it. Check that your host and any image CDN or caching layer serve it correctly before converting a whole catalogue.