WooCommerce product image size, in short: WooCommerce asks for uploads of at least 800×800 pixels. Out of the box it makes a 600 px wide main image (uncropped), 300 px wide square catalog thumbnails and 100×100 gallery thumbnails. Change them in Appearance > Customize > WooCommerce > Product Images, then regenerate thumbnails. Uploading 1200–2000 px squares keeps zoom sharp.
More on this topic: Marketplace image requirements, every guide in one place.
WooCommerce doesn't show your uploaded file directly. It makes several smaller copies of every product photo and your theme decides which copy appears where, so a perfectly good photo can still look soft in the shop grid. This guide explains the three image sizes WooCommerce creates, what to upload, where the settings live (including on block themes), how cropping works, and how to regenerate thumbnails when your images look blurry or badly cropped.
- Minimum upload: 800×800 px, per WooCommerce's own product image docs.
- Defaults (classic themes): main image 600 px wide, catalog thumbnail 300 px wide and square, gallery thumbnail 100×100 px.
- Settings: Appearance > Customize > WooCommerce > Product Images: Main image width, Thumbnail width and Thumbnail cropping (1:1, Custom or Uncropped).
- Your theme can override all of it. If it declares its own sizes, the width fields disappear and only cropping remains.
- After changes, regenerate. WooCommerce queues it in the background; you can also run WooCommerce > Status > Tools > Regenerate shop thumbnails.
What size should WooCommerce product images be?
Upload square images of at least 800×800 pixels; 1200×1200 to 2000×2000 is a safer target. WooCommerce's documentation sets 800×800 as the minimum and notes that larger images work better for products with fine detail. Going bigger than the minimum gives your theme's zoom and lightbox something to show, and covers high-density (retina) screens, which need roughly twice the displayed size to look crisp.
There's also a ceiling. Since WordPress 5.3, any upload wider or taller than 2560 px is scaled down to 2560 px and saved with a -scaled suffix (the original is kept on the server). Uploading a 6000 px camera file therefore gains nothing on the storefront and only slows your uploads.
| What you're uploading | Recommended size | Why |
|---|---|---|
| Main product image | 1200×1200 to 2000×2000 px, square | Sharp on retina screens and in zoom |
| Gallery images | Same size and shape as the main image | The gallery and its thumbnails stay even |
| Variation images | Same as the main image | They swap into the main image slot |
| Absolute minimum | 800×800 px | WooCommerce's stated minimum |
| Above this, WordPress scales down | 2560 px on the longest side | WordPress big-image threshold |
Square is the easiest shape because the catalog thumbnail is square-cropped by default. If your products are tall (bottles, clothing on a model), you can use a portrait ratio such as 4:5 instead, but use it for every product and set Thumbnail cropping to match (see below). For file weight, aim for roughly 100–300 KB per image; our free image compressor gets most product photos there without visible loss.
What image sizes does WooCommerce create?
WooCommerce registers three image sizes of its own, on top of the standard WordPress ones. These are the defaults for classic themes, from the WooCommerce developer docs:
| Size name | Where it shows | Default | Cropping |
|---|---|---|---|
| woocommerce_single | Main image on the product page | 600 px wide | Uncropped, shows the full image |
| woocommerce_thumbnail | Shop, category and related-product grids | 300 px wide | Square (1:1) by default; you can change it |
| woocommerce_gallery_thumbnail | Small thumbnails under the main image | 100×100 px | Always square |
Themes commonly change these numbers. In WooCommerce's own blurry-image guide, the Storefront theme is shown rendering catalog images at 324×324, the single product image at 800×800 (for zoom) and gallery thumbnails at 46×46. The only way to know your theme's real sizes is to check them, as described further down.
WooCommerce's default image sizes, cropping options and menu paths were checked in October 2026. Marketplaces change their rules, so confirm the current requirements in your seller dashboard before you upload a large batch.
Where do you change WooCommerce image sizes?
In the Customizer: Appearance > Customize > WooCommerce > Product Images. The settings moved there in WooCommerce 3.3.
- In your WordPress dashboard, go to Appearance > Customize.
- Open WooCommerce > Product Images.
- Set Main image width (the single product image) and Thumbnail width (the catalog grid). Height follows from the cropping setting.
- Choose Thumbnail cropping: 1:1 for squares, Custom to type your own ratio (for example 4 and 5 for portrait), or Uncropped to keep each photo's original shape.
- Check the live preview, then click Publish. Nothing changes for shoppers until you publish.
If your theme declares its own image sizes, WooCommerce hides the width controls and shows only the cropping option. That's expected; the theme's numbers win and store owners can't change them here. Ask the theme's support or check its settings panel.
On a block theme
Block themes (such as Twenty Twenty-Four or newer) often hide the Customize menu. WooCommerce's docs say you can still reach it by opening yourdomain.com/wp-admin/customize.php directly. With a block theme, the display size of product images is mostly set in the Site Editor (Appearance > Editor), in the product image and product collection blocks of your templates.
Which thumbnail cropping option should you pick?
Pick 1:1 if your product photos are square or the products are roughly as wide as they are tall. It gives the tidiest grid. Choose Custom when every product is the same non-square shape, such as 4:5 for apparel. Choose Uncropped only if your photos genuinely vary in shape and you accept a ragged grid.
| Option | Grid looks | Risk | Best for |
|---|---|---|---|
| 1:1 (square) | Even rows | Tall or wide products get trimmed at the edges | Most stores; photos shot square |
| Custom (e.g. 4:5, 3:4) | Even rows, taller tiles | Square photos get trimmed top and bottom | Apparel, bottles, posters |
| Uncropped | Uneven heights | Messy rows if shapes vary | Art, one-off items of mixed shapes |
Cropping only affects the catalog thumbnail. The main product image is uncropped by default, and the gallery thumbnails are always square. The cleanest fix is to shoot or export every photo in the same shape with the product centered and some space around it. Our free square image maker pads a photo onto a square canvas so nothing gets cut off, and the free image resizer exports any exact width and height.
Mixed backgrounds make a WooCommerce grid look untidy. Put every product on the same clean white or styled background, keeping the product as you shot it.
Make product photos7 days free · 50 credits · No credit cardHow do you regenerate thumbnails in WooCommerce?
Usually you don't have to: since WooCommerce 3.3, publishing new image settings in the Customizer or switching themes queues a background job that rebuilds the thumbnails. On a large catalog it can take a while, and an admin notice with a cancel link shows while it runs. If images still look wrong afterwards, run it by hand:
- Go to WooCommerce > Status > Tools.
- Find Regenerate shop thumbnails and click Regenerate.
- Wait for the job to finish. To follow progress, open WooCommerce > Status > Logs and pick the wc-background-regeneration log.
- Clear any page cache or CDN cache, then reload the shop page.
Run it again whenever you upload replacement images in bulk, change the image settings or switch themes. Two things can stop the background job: a site behind password protection (BasicAuth), which blocks the background requests, and a code snippet that turns background regeneration off. In either case the free Regenerate Thumbnails plugin from WordPress.org, which WooCommerce's docs point to, does the same job on demand. If you use Jetpack's image CDN, images are resized on the fly instead and regeneration matters less.
Why are my WooCommerce product images blurry?
Almost always because the image being shown is smaller than the space it fills, so the browser stretches it. WooCommerce's troubleshooting guide names three causes: theme styles that display images larger than the sizes WooCommerce generated, originals smaller than about 800×800, and image size settings set too low. Here's how to find which one it is:
- Check the original. In Media > Library, click the image and read its dimensions under Attachment Details. Anything under 800 px needs replacing.
- Measure what your theme displays. On the shop page, right-click a product image, choose Inspect and note the rendered width. Do the same on a product page and for the gallery thumbnails.
- Double it for retina. A thumbnail shown at 300 px wide needs a 600 px file to look crisp on high-density screens.
- Raise the settings. Set Main image width and Thumbnail width to at least those numbers in the Customizer and publish.
- Regenerate thumbnails as above, and clear your caches.
If the original itself is small, raising settings won't help: WordPress can't create a size larger than the upload. Find a bigger original, or enlarge it with our AI image upscaler (3 credits), which makes it 4× larger and redraws edges, then re-upload. Our guide to upscaling product photos covers when that works well.
Which file format is best for WooCommerce images?
JPG or WebP for photos, PNG only for graphics that need transparency or sharp text. WordPress has accepted WebP uploads since version 5.8, and WebP files are usually noticeably smaller than JPGs at the same quality. Whatever the format, use the sRGB color profile so colors match across browsers. The full comparison is in JPG vs PNG vs WebP for product images.
For sizes on other parts of your site, such as banners and blog images, see website image sizes; selling on Shopify too? The numbers there differ, covered in Shopify product image size.
Frequently asked questions
What is the best image size for WooCommerce products?
Square images between 1200×1200 and 2000×2000 pixels. WooCommerce's minimum is 800×800, and WordPress scales anything over 2560 px down automatically, so there's no benefit in uploading larger.
What are the default WooCommerce image sizes?
On classic themes, the main product image is 600 px wide and uncropped, the catalog thumbnail is 300 px wide and square-cropped, and gallery thumbnails are 100×100 px. Many themes set their own values instead.
Where are the WooCommerce image settings?
Appearance > Customize > WooCommerce > Product Images. If your block theme hides the Customize menu, open yourdomain.com/wp-admin/customize.php directly.
Why can't I change the image width in WooCommerce?
Your theme has declared its own image sizes, so WooCommerce hides the width fields and leaves only the cropping option. The theme's values apply; check its settings or documentation.
Do I need the Regenerate Thumbnails plugin?
Usually not. Since WooCommerce 3.3, thumbnails are regenerated in the background after you publish Customizer changes or switch themes, and WooCommerce > Status > Tools has a Regenerate shop thumbnails button. The plugin is a fallback if background jobs can't run on your host.
How do I stop WooCommerce cropping my product images?
Set Thumbnail cropping to Uncropped in the Product Images settings, or keep 1:1 and upload square photos with the product centered so nothing important is trimmed. Then regenerate thumbnails.
Should WooCommerce product images be square?
Square is the simplest choice because catalog thumbnails are square by default and gallery thumbnails are always square. A consistent portrait ratio such as 4:5 also works if you set Custom cropping to match.
Does DPI matter for WooCommerce images?
No. Browsers use pixel dimensions only, so a 72 DPI and a 300 DPI file with the same pixels look the same. See how to change image DPI for when it does matter.
Turn plain product shots into clean white or lifestyle images in the same style, then export them square and ready to upload.
Start free trialSee pricing7 days free · 50 credits · No credit card. Trial images carry a small “Made with aiarter” mark; paid plans export clean files you can use commercially.
