WooCommerce platform guide
WooCommerce product image size and thumbnails
Get the upload size WooCommerce recommends, the three image sizes it creates from each upload and the settings that control cropping, plus a short check for blurry product images.
WooCommerce recommends uploading product images that are at least 800 x 800 pixels. From each upload it creates a single product image, a catalog image and a product thumbnail, and your theme decides how large each one finally displays.
The values below come from WooCommerce’s own documentation. Themes and future WooCommerce releases can change them, so check your store’s Customizer and the current docs before a large upload.
01 · Current values
WooCommerce product image sizes at a glance
These are the values WooCommerce publishes for product images. Where its documentation does not set a value, the table says so instead of filling the gap.
| Field | WooCommerce value | How to use it |
|---|---|---|
| Recommended upload size | At least 800 x 800 pixels | WooCommerce says this size renders well as the single product image, catalog image and thumbnail. Larger images are better for products with fine detail. |
| Single product image | Shown uncropped; defaults to 600px wide | This is the main image on the product page. Its shape follows your upload, so choose one aspect ratio for all main images. |
| Catalog image (thumbnail) | Defaults to 300px wide, square cropped | Used on the shop page, category pages, related products, up-sells and cross-sells. Keep the product centered so a square crop never cuts it. |
| Gallery thumbnail | Always square cropped; defaults to 100 x 100 pixels | Shown below the main image to switch between gallery images. The product should still be recognizable at this size. |
| Thumbnail cropping | 1:1 square, Custom ratio or Uncropped | Set in Appearance > Customize > WooCommerce > Product Images. These settings do not apply to the single product image. |
| File formats and maximum file size | Not set in the WooCommerce pages checked | Product images are uploaded through the WordPress Media Library, so the limits come from your WordPress site and hosting rather than WooCommerce. |
Source: WooCommerce documentation “Adding Product Images and Galleries”, “Product Page and Images” (Customizer), “Fixing blurry product images” and the developer doc “Image sizing for theme developers”, checked 15 October 2026. Your theme can declare its own widths, which hides the width controls in the Customizer.
02 · Cropping settings
Choose a WooCommerce thumbnail crop that fits your catalog
The Customizer offers three cropping options for catalog and thumbnail images. Each one changes what your images need to look like before upload.
Default
1:1 square images
All catalog images appear as squares, which keeps product grids even. Center the product and leave a little space on every side so nothing important is trimmed.
Your ratio
Custom ratio
Enter a ratio such as 3:4 for tall products. WooCommerce notes that an image that is not large enough for the ratio will not fill it, so export every image in that same shape.
As uploaded
Uncropped
Images keep their own shape, which can make rows look uneven. Use it only when every product image already shares one aspect ratio.
After any change
Regenerate thumbnails
After you change a width, a cropping option or your theme, go to WooCommerce > Status > Tools and run Regenerate shop thumbnails so older images use the new sizes.
03 · Blurry images
Why WooCommerce product images look blurry and how to fix them
WooCommerce’s own troubleshooting guide traces most blurry product images to files that are too small or image settings that are lower than what the theme displays.
Check the original file
Open the image in the Media Library and read its dimensions in Attachment Details. For most themes the original should be at least 800 x 800 pixels; replace anything smaller with a higher-resolution version.
Match what the theme renders
Inspect a product image in your browser’s developer tools to see the size the theme displays, then set Main image width to match or exceed it. In the Storefront theme the largest single product image is 800 x 800 pixels, which the zoom effect needs.
Plan for retina screens
For sharp images on high-DPI displays, WooCommerce suggests setting thumbnails to double the size the theme renders, for example 160 x 160 for an 80 x 80 slot. Larger images load more slowly, so check which devices your shoppers use first.
Regenerate, then recheck
After replacing files or changing settings, regenerate shop thumbnails and reload the shop page, a product page and the cart to confirm the fix.
04 · Using MakeAD images
Check MakeAD output against WooCommerce’s sizes before you upload
MakeAD turns one product photo into new clean or lifestyle images. Here is how its output relates to the values above.
01Single-purpose tools export at 1K
Tools such as product staging and background removal export at the 1K setting. Open the downloaded file and compare its pixel dimensions with WooCommerce’s 800 x 800 recommendation and the size your theme displays, and do not stretch a small file. Product staging exports a 4:5 frame, so leave space above and below the product if your catalog uses square crops.
02The homepage generator offers 1:1 and 2K or 4K settings
Choose the 1:1 aspect ratio to match WooCommerce’s default square catalog crop, or the ratio you entered as a custom crop. Higher resolution settings use more credits. Whichever setting you choose, check the exported pixel dimensions yourself.
03Keep one look across the catalog
Use the same background style, product scale and ratio for every main image so the shop grid stays even, and compare each generated image with your source photo so color, shape and labels match the product you ship.
05 · Final image check
Check your WooCommerce product images before you publish
Check the exact files you are about to upload, in the theme your store actually uses.
Size
Each original is at least 800 x 800 pixels and at least as large as the biggest size your theme displays, and none was stretched from a smaller file.
Crop
The product stays whole in the square or custom catalog crop and in the 100 x 100 gallery thumbnail.
Main image and gallery
The product image is set separately from the gallery. WooCommerce always shows it first, so you do not need to add it to the gallery again.
Thumbnails regenerated
If you changed widths, cropping or theme, shop thumbnails were regenerated before you reviewed the store.
Selling on Shopify too
Each platform sets its own image rules. Re-check the same files against Shopify’s sizes before reusing them there.
Also on Shopify? Check Shopify product image sizeQuestions that need judgment
Frequently asked questions
These answers cover the exceptions and review tests that still depend on context.
What is the best product image size for WooCommerce?
WooCommerce recommends uploading product images that are at least 800 x 800 pixels. It generates the smaller display sizes for you, and larger images are better for products with fine detail.
What is the default WooCommerce thumbnail size?
By default the catalog thumbnail is 300 pixels wide and square cropped, the gallery thumbnail is 100 x 100 pixels, and the single product image is 600 pixels wide and uncropped. Your theme can set different widths.
How do I stop WooCommerce from cropping product images?
Go to Appearance > Customize > WooCommerce > Product Images and choose Uncropped, then regenerate shop thumbnails. Images will keep their own shape, so rows may look uneven unless all your images share one ratio.
Why are my WooCommerce product images blurry?
Usually the uploaded file is smaller than 800 x 800 pixels or your image width settings are lower than the size the theme displays. Upload a larger original, raise the width to match the theme and regenerate shop thumbnails.
One photo, a consistent WooCommerce catalog
Create WooCommerce product images from one product photo
Upload one clear product photo to MakeAD to create a clean square main image, a lifestyle scene or a supporting view, then check the pixel size and crop in your store before you publish.
Create my WooCommerce product images