Skip to content

Article · Part of the guide Product image optimization for fashion stores

WooCommerce product image size: what to upload and how to set it

WooCommerce asks you to upload product images of at least 800 x 800 pixels, and larger for products with fine detail such as fabric. From each upload it creates three display sizes: a single product image 600 pixels wide and uncropped, a shop thumbnail 300 pixels wide and cropped square, and a gallery thumbnail of 100 x 100 pixels, unless your theme sets its own. You change the widths and the cropping in the Customizer, then regenerate thumbnails so existing images use the new sizes.

The three WooCommerce image sizes

Default WooCommerce image sizes, from the WooCommerce developer documentation read on 2026-11-12
Size nameWhere it showsDefault
woocommerce_singleThe main image on the single product page600 px wide, uncropped
woocommerce_thumbnailProduct grids such as the shop and category pages300 px wide, square cropped
woocommerce_gallery_thumbnailThe small images under the main image in the product gallery100 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

  1. 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.

  2. 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.

  3. Set the thumbnail width and cropping

    Enter the thumbnail width and choose 1:1 square, a custom ratio or uncropped.

  4. Publish

    Click Publish so the new settings are saved for the whole store.

  5. 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:

  1. The upload is too small. If the original is smaller than the size the theme displays, the browser stretches it. Upload a larger original.
  2. Old thumbnails. You changed the sizes but did not regenerate, so the store still serves the old small copies.
  3. 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.
  4. Heavy compression. An image optimization tool set too aggressively can blur fabric texture. Lower its compression level and compare.
  5. 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

  1. Edit the product

    In the WordPress admin, go to Products and open the product for editing.

  2. Set the product image

    In the Product image box on the right, click Set product image and upload or choose your lead image.

  3. Add the gallery

    In the Product gallery box, click Add product gallery images, select the remaining images and click Add to gallery.

  4. 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.

Questions and answers
What is the best image size for WooCommerce products?

Upload at least 800 x 800 pixels, as WooCommerce asks, and preferably a larger master size around 2000 pixels on the long side for sharp zoom on fabric. Keep one aspect ratio for all main images.

Where do I change the WooCommerce product image size?

In a classic theme, in the Customizer under WooCommerce and Product Images. If your theme declares its own sizes, the width fields are hidden and only the cropping choice remains.

Why did my new image size settings not change anything?

Existing images keep their old copies until you regenerate thumbnails. Publish the Customizer changes, run a thumbnail regeneration tool and clear any site cache.

Should WooCommerce thumbnails be square for clothing?

Square works if your photos are square. For portrait photos of models, a custom ratio such as 3:4 shows the whole outfit in the shop grid without cropping it.

Does WooCommerce resize my images automatically?

Yes. WooCommerce keeps the original and generates the display sizes for the product page, the shop grid and the gallery thumbnails.

Your next collection could be online this week.

20 credits on us · no card