The three WooCommerce image sizes
| Size name | Where it shows | Default |
|---|---|---|
| woocommerce_single | The main image on the single product page | 600 px wide, uncropped |
| woocommerce_thumbnail | Product grids such as the shop and category pages | 300 px wide, square cropped |
| woocommerce_gallery_thumbnail | The small images under the main image in the product gallery | 100 x 100 px |
These are display sizes, not upload sizes. WooCommerce keeps your original file and generates smaller copies for each place an image appears. A theme can declare its own widths for the first two, and many fashion themes do, so the numbers on your store may differ from the defaults above.
What size to upload
WooCommerce's own documentation asks for images of at least 800 x 800 pixels and says larger images are better for products with fine detail. Clothing is exactly that kind of product: knit texture, stitching, prints and buttons are what shoppers zoom in on.
In practice, upload one master size for the whole catalog, larger than the biggest size your theme displays. Something around 2000 pixels on the long side gives the zoom real detail without making files unwieldy. Keep the same aspect ratio for every main image so the shop grid lines up. Our article on the best image size for an ecommerce website explains how to choose that master size if you also sell on other channels.
Do not resize images down to 600 pixels before uploading just because that is the default display width. WooCommerce creates the small copies itself; if you upload small, the zoom and any future theme with larger images will have nothing to work with.
How to change the image sizes
Open the Customizer
In a classic theme, go to Appearance, Customize, then WooCommerce and Product Images. Block themes can handle images differently, so check your theme's documentation if you do not see this panel.
Set the main image width
Enter the width for the single product image, if your theme shows the field. The single image is uncropped by default.
Set the thumbnail width and cropping
Enter the thumbnail width and choose 1:1 square, a custom ratio or uncropped.
Publish
Click Publish so the new settings are saved for the whole store.
Regenerate thumbnails
Existing images keep their old copies until thumbnails are regenerated to the new dimensions. Use a thumbnail regeneration tool and let it finish before you judge the result.
The developer documentation is clear on the last step: changes are not visible to customers until the Customizer is published and the thumbnails have been regenerated. Skipping it is the most common reason store owners think the settings did not work.
Square, custom or uncropped thumbnails
WooCommerce offers three cropping choices for the shop thumbnails: 1:1 square, a custom aspect ratio that you enter, or uncropped, which keeps the original shape of each image.
For clothing, square is the safe default if your photos are square. If you shoot portrait images of models, set a custom ratio that matches them, such as 3:4, so the grid shows the full outfit instead of cutting off the head or the shoes. Uncropped only works well when every image already has the same shape; if they differ, the grid becomes uneven.
Whatever you pick, frame your photos with some space around the garment. A crop that is fine on the product page can cut a hem or a sleeve in the grid if the garment touches the edge of the frame.
When your theme decides the sizes
Since WooCommerce 3.3, a theme can declare its own image widths. When it does, the width fields disappear from the Customizer and only the cropping option stays visible, so you cannot change the widths there.
That is not a fault. It usually means the theme designer matched the image sizes to the layout. If the result looks wrong, check the theme's settings panel or documentation first, and ask the theme's support before editing code. Changing image sizes in a child theme is a developer task; it also requires regenerating thumbnails afterwards.
Why WooCommerce product images look blurry
Blurry or soft product images usually come from one of these causes:
- The upload is too small. If the original is smaller than the size the theme displays, the browser stretches it. Upload a larger original.
- Old thumbnails. You changed the sizes but did not regenerate, so the store still serves the old small copies.
- Theme layout wider than the image size. A full width product layout may show the image larger than the single image width. Raise the width in the Customizer or theme settings, then regenerate.
- Heavy compression. An image optimization tool set too aggressively can blur fabric texture. Lower its compression level and compare.
- Soft source photos. A slightly out of focus phone photo stays soft at any size. Reshoot, or generate a clean new image from good source photos.
Work through the list in that order; the first two explain most cases on small stores.
Variation images for colors and sizes
Clothing usually comes in several colors, and shoppers expect the photo to change when they pick one. In WooCommerce each variation of a variable product can have its own image, set in the Variations panel of the product editor. When a shopper selects that color, the main image switches to it.
The size rules are the same as for the main image: use your master size and the same aspect ratio, or the gallery jumps when the shopper changes color. Give every color its own photo rather than one group shot of all colors. Google Merchant Center, for example, asks merchants to match the image to the exact product option being sold and to show the real color, pattern and material, so one image per variant is good practice beyond your own store too.
If reshooting every color is not practical, photograph each color variant once under the same light and generate the rest of the set from those photos, so the colors stay true and the style stays the same across the range. Check each finished image against the real garment before it goes live, in daylight and on more than one screen, because a shopper who receives a different shade than the photo showed has a good reason to send it back.
Adding the images to a product
Edit the product
In the WordPress admin, go to Products and open the product for editing.
Set the product image
In the Product image box on the right, click Set product image and upload or choose your lead image.
Add the gallery
In the Product gallery box, click Add product gallery images, select the remaining images and click Add to gallery.
Save
Click Update. The product image always appears first in the gallery on the product page.
Name each file descriptively before uploading and write alt text for every image in the media library. Both are covered in this guide's articles on image file names and alt text for product images.
Consistent images for every product with AI
Image size settings only help if the photos themselves are consistent. If your catalog mixes supplier photos, phone shots and old studio images, Wizia AI Studio can turn a few clear photos of each garment into studio product images and on-model photos in one style. You choose 1K, 2K or 4K before generating; 1K and 2K cost 1 credit per image and 4K costs 2 credits, and the help center calls 2K the standard for product pages.
The images download as ordinary files, so you upload them through the same Product image and Product gallery boxes described above. There is no automatic link between Wizia and your store; you decide which images go live. If you also want shoppers to see garments on themselves, the Wizia try-on for WooCommerce installs with one script tag pasted into the site. Full resolution downloads are on Starter and higher, and the Free plan includes 20 one-time credits to test.