WooCommerce handles three product image sizes, and it treats them differently in a way that catches most stores out. woocommerce_thumbnail drives the catalog grid and defaults to 300px wide, square cropped. woocommerce_gallery_thumbnail drives the small navigation strip and defaults to 100 by 100 pixels, always square cropped. woocommerce_single drives the main product image, defaults to 600px wide, and is always uncropped (developer.woocommerce.com, accessed August 2026).
The part that causes the support tickets: the cropping controls in the Customizer do not touch the main image at all. WooCommerce’s own documentation states plainly that Product Image settings in the WooCommerce Customizer do not apply to the featured product image (woocommerce.com, accessed August 2026). So a store owner sets everything to 1:1, sees a tidy grid, then opens a product page and finds the main image still the shape it was uploaded.
This guide covers what those settings actually control, what resolution to upload, and how to fill a WooCommerce catalog when you cannot shoot every SKU.
Key Takeaways
Three sizes, two behaviours. Grid and gallery thumbnails are cropped. The main product image is not.
The Customizer controls the catalog, not the product page. WooCommerce documents this explicitly, and it is the single most common source of confusion.
Upload one large master. WordPress generates the smaller sizes from it. Uploading at display size is how stores end up with soft images on retina screens.
Shoot a consistent ratio or accept whitespace. Uncropped main images inherit whatever shape you gave them, so mixed ratios make a product page look unfinished.
Regenerating thumbnails is a required step after any size change. Existing images keep their old dimensions until you do.
The catalog grid is the conversion surface. It is seen far more often than any single product page, and it is the one WooCommerce does crop for you.
What are the three WooCommerce image sizes?
WooCommerce registers three, and knowing which one you are looking at solves most sizing problems.
| Size | Default | Cropping | Where it appears |
|---|---|---|---|
woocommerce_thumbnail | 300px wide | Square cropped | Shop, category and related-product grids |
woocommerce_single | 600px wide | Always uncropped | Main image on the product page |
woocommerce_gallery_thumbnail | 100 x 100px | Always square cropped | The small strip under the main image |
Those are WooCommerce’s documented defaults (developer.woocommerce.com, accessed August 2026). Themes routinely override them, so if your numbers look different, your theme has set its own and that is normal.
The uncropped behaviour of woocommerce_single is a deliberate design decision, not an oversight. WooCommerce leaves the main image alone so it never chops a detail out of the shot a customer is trying to examine. The consequence is that whatever aspect ratio you upload is the aspect ratio a buyer sees, and a product page with a portrait, a square and a landscape image across three SKUs looks unmanaged.
Where do you change WooCommerce image sizes?
Appearance > Customize > WooCommerce > Product Images. That panel gives you a thumbnail width and a cropping choice, and the cropping choice has three options (woocommerce.com, accessed August 2026):
- 1:1 produces square images, and all images appear as 1:1 squares.
- Custom takes a ratio you enter.
- Uncropped shows images as they are, which WooCommerce notes can result in images appearing non uniformly.
Two things to internalise about that panel. It governs the catalog and gallery thumbnails only, not the featured image. And whatever you set there applies to images WordPress generates from that point forward.
That second point is where stores get stuck. Changing the setting does not retroactively resize the images already in your media library. You need to regenerate thumbnails afterwards, which is a standard maintenance task rather than a workaround. Until you do, your grid runs a mix of old and new dimensions.
Choose Uncropped only if you can guarantee every product image is already the same shape. WooCommerce’s own wording is the warning: images appear non uniformly. For most catalogs 1:1 is the correct answer, because square tiles are what make a grid read as a shop rather than a collection.
What resolution should you upload?
Larger than the display size, and consistently shaped. WordPress generates the smaller versions from your upload, so the file you upload is the master that everything else is derived from.
A practical target for most stores is a square master at 1500 to 2000 pixels on each side. That comfortably feeds a 600px main image on a retina screen, survives a zoom feature, and leaves room if you later widen the theme. Uploading at 600px because that is the documented default is a false economy: the image is then exactly one pixel per display pixel on a standard screen, and visibly soft on every modern phone.
The opposite error costs you speed. A 6000px camera original at several megabytes per file, multiplied across a few hundred SKUs, is a slow catalog and a large backup. Resize the master before upload rather than relying on the store to serve a scaled version.
If your source material is already too small to work with, that is a different problem and no setting fixes it. Low resolution product images covers what can and cannot be recovered.
How do you shoot for a WooCommerce catalog?
The same discipline that works on any listing platform, with one WooCommerce-specific rule added: pick one aspect ratio and hold it across every SKU, because the main image will not be cropped for you.
The set that covers most physical products:
- A clean packshot on a plain ground. This is the grid tile and it does the most work.
- Two or three alternate angles. Front, three-quarter, back or underside depending on the product.
- A detail shot of texture, finish, closure or whatever the buyer would pick up and inspect.
- A scale or in-context shot so nobody has to convert millimetres in their head.
- A lifestyle or styled scene for products where the setting is part of the sell.
Shoot all of them square and the WooCommerce sizing question disappears. Product photography angles covers which angles matter by product type, and ecommerce product photography covers the shoot itself.
The reason to be strict about the grid tile specifically: a shopper sees the catalog grid many times more often than any individual product page. It is the surface where a store either looks coherent or looks assembled from supplier photos of varying provenance.
How do you fill a WooCommerce catalog without shooting every SKU?
This is the real constraint for most WooCommerce stores, which are smaller and leaner than the Shopify Plus tier and often run by one or two people. Five images across two hundred products is a thousand photographs.
The workable approach is to shoot once per product and derive the rest. Photograph the packshot properly, then generate the alternate angles, the styled scenes and the seasonal variants from that single source image. DesignerBox’s photo angles app produces additional views from one photo, and the styled scene generator handles the context shots.
Two things to keep on the human side of the line. Anything that carries a factual claim about the product, colour, finish, size, condition, needs to derive from a real photograph of the real item, not from a text prompt. And anything with a person in it picks up disclosure obligations that vary by jurisdiction, covered in labelling AI-generated images.
For inherited supplier photography, which most WooCommerce dropship and reseller stores are working from, the job is different: regrounding and standardising rather than creating. AI background removal covers lifting products off inconsistent backgrounds onto one ground, which is what turns a supplier feed into something that looks like a single store.
Does image work actually move conversion?
There is one controlled result worth knowing rather than the usual vendor folklore. A 2024 RecSys study found that generated product images produced a measurable click-through lift, around 15% and statistically significant, concentrated in apparel categories. That is a real experiment with a stated methodology, which is more than most claims in this category have.
Apply it carefully. It measures generated imagery against a baseline in a specific catalog, not a promise for your store. The honest framing for a WooCommerce owner is that image consistency and completeness are worth testing, and your own store’s data is the only evidence that settles it. PDP images and conversion covers what to test and in what order, and ecommerce image testing covers running the test properly.
If you also sell on Shopify or a marketplace, the specs differ and the rules differ. Shopify product image size covers that platform’s limits, which are stricter in some places and looser in others. PrestaShop product images covers the other major self-hosted option, which handles sizing in an almost opposite way: one master upload generates every size, so the upload is your only quality gate.
What does this cost to run?
The photography setup is the same as any small store: a window, a board, a tripod, and a fixed spot you return to. Under $50 of kit.
Generation costs are per operation. An image operation on DesignerBox costs 5 credits, so the free tier’s 112 credits covers 22 of them, and Basic at $15 a month covers 100. For a 200 SKU catalog needing three derived images each, that is 600 operations or 3,000 credits, which lands on Premium at $75 a month or a credit pack on top of a smaller plan.
The tier note that matters for a commercial store: a commercial licence starts at Pro, $35 a month. Below that the licence does not cover selling. DesignerBox’s page for ecommerce brands covers the catalog workflow, and current pricing has the live numbers.
FAQ
What is the default WooCommerce product image size?
WooCommerce defaults to 300px wide for the catalog thumbnail, 600px wide for the main single product image, and 100 by 100 pixels for the gallery navigation thumbnails (developer.woocommerce.com, accessed August 2026). Themes frequently override these, so check yours rather than assuming the defaults are in force.
Why is my WooCommerce main product image not cropping?
Because it is not supposed to. woocommerce_single is always uncropped by default, and WooCommerce’s documentation states that the Product Image settings in the Customizer do not apply to the featured product image (woocommerce.com, accessed August 2026). To control the main image shape, upload every product image at the same aspect ratio.
What size images should I upload to WooCommerce?
Larger than the display size, and consistently shaped. A square master between 1500 and 2000 pixels per side suits most stores: it feeds a 600px main image sharply on retina screens without bloating your media library. WordPress generates the smaller sizes from the file you upload.
Do I need to regenerate thumbnails after changing image sizes?
Yes. Changing the setting affects images generated from that point forward, so images already in your media library keep their previous dimensions until you regenerate. Skipping this step is why a store often sees a mix of old and new sizes in the grid after a settings change.
Should I use 1:1 or uncropped for WooCommerce thumbnails?
1:1 for almost every store. WooCommerce’s own description of the uncropped option warns that images appear non uniformly, which is exactly what makes a catalog grid look unmanaged. Uncropped only makes sense if every product image is already identically shaped.
Can I use AI-generated product images on WooCommerce?
WooCommerce is store software rather than a marketplace, so it sets no content rules of its own. The obligations come from consumer law and from any advertising channel you feed, and they centre on accuracy: the image must not misrepresent what the buyer receives. Generated imagery derived from a real photograph of the real product sits on the right side of that. A product invented from a text prompt does not.
How many images should a WooCommerce product have?
Five is a reasonable working target for physical products: a clean packshot, two or three alternate angles, a detail shot, something for scale, and a context shot. The packshot carries the grid tile and does the most work, so it is the one to shoot properly if you only shoot one.
Sources
- WooCommerce image sizing for theme developers: https://developer.woocommerce.com/docs/theming/theme-development/image-sizes/
- WooCommerce Customizer, product page and images: https://woocommerce.com/document/woocommerce-customizer/product-page-and-images/
WooCommerce image size defaults and Customizer behaviour verified from WooCommerce’s own developer and user documentation as of August 2026. Themes override these defaults routinely, so confirm against your own installation. DesignerBox pricing and credit costs are current as of August 2026.
