The WooCommerce product image size system registers three 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 by default (developer.woocommerce.com, accessed September 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 September 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 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 thumbnails. It does not control the main product image. WooCommerce documents this, and it causes a lot 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.
-
WooCommerce regenerates thumbnails in the background after you publish a size change. If that job is cancelled or turned off, regenerate them by hand.
-
The catalog grid is where shoppers compare many products at once, and it is the one WooCommerce does crop for you.
What are the three WooCommerce product image size defaults?
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 by default | 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 September 2026). Since WooCommerce 3.3.0, themes can declare their own sizes, and then the store owner cannot change the widths. So if your numbers look different, your theme has set its own and that is normal.
WooCommerce says woocommerce_single shows the full product image as uploaded. So no detail is cut from the shot a customer is trying to examine. 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 September 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, and it does not touch the featured image. And a change there reaches the live store only after you publish it and the thumbnails are regenerated.
That second point is where stores get stuck. Since WooCommerce 3.3, publishing a size change in the Customizer queues a background job that regenerates the thumbnails (developer.woocommerce.com, accessed September 2026). Until that job finishes, some images keep their old dimensions. If the job is cancelled, or background regeneration is turned off, run Regenerate Shop Thumbnails under WooCommerce > Status > Tools.
Choose Uncropped only if you can guarantee every product image is already the same shape. WooCommerce’s own wording is the warning: it can result in images appearing 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 high-density phone screens.
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: many shoppers see the catalog grid before they open a single 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?
For a store run by one or two people, this is the real constraint. 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 make the alternate angles, the styled scenes and the seasonal variants from that single source image. In DesignerBox, a multi-angle template makes more views from one photo, and a product scene template makes 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 can carry disclosure obligations that vary by jurisdiction, covered in labelling AI-generated images. This is general information, not legal advice.
For inherited supplier photography, which many dropship and reseller stores work 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 move conversion?
There is one controlled result worth knowing. In a 2024 RecSys industry paper, Czapp and colleagues tested generated backgrounds on product images in retargeting ads. In the first test phase, products with generated backgrounds gained about 15% in click-through rate over the baseline, the gain was statistically significant, and most of the products were apparel. In later tests the gain ranged from about 4% to 40%, depending on the merchant’s catalog, the ad placements and the original images (arXiv, accessed September 2026). The primary metric was clicks, and the authors report that conversions also improved as an indirect effect. That is a real experiment with a stated method.
Apply it carefully. It measures generated backgrounds in retargeting ads. It did not test store product pages. Your store may see a different result. 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. It also builds every size from one master upload, so the upload is your quality gate there too.
Kit and run costs
The photography setup is the same as any small store: a window, a board, a tripod, and a fixed spot you return to. None of it is expensive.
On DesignerBox, the cost of a run depends on the model the workflow uses, and the cost is shown before the run. Plans are billed monthly: the free plan includes 112 credits a month, Basic is $15 for 500 credits, Pro is $35 for 1,000 and Premium is $75 for 2,500. A 200-SKU catalog with three derived images per product is 600 images. Check the cost shown on your first run against your plan’s allocation before you run the next products. Current pricing has the live numbers.
The tier note that matters for a commercial store: the commercial licence starts at Pro, $35 a month billed monthly. DesignerBox’s page for ecommerce brands covers the catalog work.
Build the job once as a workflow with your brand and your product photo. It runs the same way on the next product. Start from a template with a photo of your own product.
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 September 2026). Themes can declare their own sizes, 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 September 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?
Usually not by hand. Since WooCommerce 3.3, publishing a size change in the Customizer, or switching themes, queues a background job that regenerates the thumbnails. Run Regenerate Shop Thumbnails under WooCommerce > Status > Tools if that job was cancelled, if background regeneration is turned off, or if the grid still shows old sizes (developer.woocommerce.com, accessed September 2026).
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 it can result in images appearing 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 you run yourself, so the image rules come mainly from consumer law and from any sales or advertising channel you feed. They centre on accuracy: the image must not misrepresent what the buyer receives. Generated imagery made from a real photograph of the real product is easier to keep accurate. A product invented from a text prompt has no real item behind it. This is general information, not legal advice.
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
- Image sizing for theme developers, WooCommerce developer docs, accessed September 2026
- Thumbnail image regeneration, WooCommerce developer docs, accessed September 2026
- WooCommerce Customizer, product page and images, WooCommerce documentation, accessed September 2026
- Dynamic Product Image Generation and Recommendation at Scale for Personalized E-commerce, Czapp, Jani, Domián and Hidasi, RecSys 2024, accessed September 2026
- DesignerBox pricing page (designerbox.ai/pricing), September 2026
WooCommerce image size defaults, Customizer behaviour and thumbnail regeneration verified from WooCommerce’s own developer and user documentation as of September 2026. Themes can declare their own sizes, so confirm against your own installation. DesignerBox plans verified on the DesignerBox pricing page, September 2026.
