WooCommerce · Guide
How to Change WooCommerce Product Image Size (Step by Step)

Short answer
Go to Appearance, Customize, WooCommerce, Product Images and set the main image width, thumbnail width and cropping ratio, then publish. If those settings are missing, your theme controls the sizes or you use a block theme, so change them in the theme settings or Site Editor instead.
Key takeaways
- Product image sizes live under Customize, WooCommerce, Product Images.
- WooCommerce uses single, catalog thumbnail and gallery thumbnail sizes.
- Themes that set their own sizes hide the Customizer fields.
- Block themes control images through product image blocks.
- WooCommerce usually regenerates resized images in the background.
How do you change WooCommerce product image size?
You can change WooCommerce product image sizes under Appearance, Customize, WooCommerce, Product Images, where you set the main image width, the thumbnail width and the cropping ratio.
WooCommerce then creates new image sizes for your products. Recent versions regenerate them in the background, so you usually do not need to rebuild thumbnails by hand.
Some themes control these sizes themselves, and block themes may handle images through blocks instead. If the settings are missing or have no effect, that is usually why.
This guide covers the Customizer method, theme and block settings, code filters for developers, and how to fix images that still look wrong after the change.
Which image sizes does WooCommerce use?
WooCommerce uses three main image sizes: a single product image, a catalog thumbnail for shop and category pages, and a small gallery thumbnail below the main image.
| Image size | Where it shows | Setting name in code | Typical default |
|---|---|---|---|
| Single product image | Main image on the product page | woocommerce_single | 600px wide, uncropped |
| Catalog thumbnail | Shop, category and related product grids | woocommerce_thumbnail | 300px wide, 1:1 crop |
| Gallery thumbnail | Small images under the main image | woocommerce_gallery_thumbnail | 100px square |
The defaults above are from the WooCommerce documentation on image sizes. Your theme may change them, so check what your store actually uses.
These sizes sit alongside the standard WordPress sizes such as thumbnail, medium and large. WooCommerce registers its own so shop layouts can use dimensions that suit products.
How do you change image sizes in the Customizer?
Go to Appearance, Customize, then WooCommerce, then Product Images, and adjust the main image width, thumbnail width and thumbnail cropping before publishing.
- In your dashboard, open Appearance and choose Customize.
- Click WooCommerce in the Customizer menu.
- Open Product Images.
- Enter a new Main image width in pixels.
- Enter a new Thumbnail width in pixels.
- Choose a Thumbnail cropping option.
- Click Publish to save.
The cropping options are 1:1 for square thumbnails, Custom for a ratio you choose, such as 4:3, and Uncropped to keep each image's original shape.
Square crops keep shop grids tidy, but they can cut off the top or bottom of tall products. Uncropped keeps the full product but can make grid rows uneven.
Custom ratios suit stores with consistent product shapes. A clothing shop with tall photos might pick 3:4, while a furniture shop with wide photos might choose 4:3.
The ratio you pick should match most of your photos, not the odd exception. If only a few products look awkward, re-shoot or re-crop those images instead of changing the whole store.
The WooCommerce Customizer documentation covers the other store settings in the same panel.
Why can't you see the Product Images settings?
If the Product Images section is missing, your theme probably sets the image sizes itself, or you are using a block theme that handles product images differently.
Themes can declare fixed widths when they add WooCommerce support. When a theme does this, WooCommerce hides the matching Customizer fields, because the theme's values take priority.
In that case, look in the theme's own settings panel or documentation for shop or product image options. Many WooCommerce-focused themes have a dedicated section for this.
Block themes do not show the Customizer in the Appearance menu by default. Product images are then controlled by the Product Image and Product Image Gallery blocks inside your shop and product templates.
How do you change product image sizes in a block theme?
In a block theme, open the product or shop template in the Site Editor and adjust the settings on the product image blocks, such as size, aspect ratio and scale.
Go to Appearance, Editor, then Templates, and open Single Product or Product Catalog. Select the product image block and look at its settings sidebar.
Options vary between WooCommerce versions, but you can usually choose the image size the block loads and how it fits its container. The Site Editor documentation explains how templates work.
Save the template and check a few products on the front end, including ones with tall and wide images. Our guide on customizing WooCommerce pages covers more template changes.
How do you change product image sizes with code?
Developers can change WooCommerce image sizes with filters such as woocommerce_get_image_size_single, which override the stored dimensions for each size.
Add code like this to a child theme's functions file or a code snippets plugin:
add_filter( 'woocommerce_get_image_size_gallery_thumbnail', function( $size ) {
return array(
'width' => 150,
'height' => 150,
'crop' => 1,
);
} );
Matching filters exist for the single image and the catalog thumbnail. Theme developers can also pass widths when declaring WooCommerce support, as shown in the WooCommerce image sizes guide for theme developers.
Keep code changes in a child theme or snippets plugin, so theme updates do not remove them. Test on staging before changing a live store.
Do you need to regenerate thumbnails after changing sizes?
Usually not, because WooCommerce regenerates resized product images in the background after you change the settings, but large stores can take a while to catch up.
Background regeneration runs through scheduled tasks. On stores with thousands of products, it may take some time before every image uses the new size.
If images still look old after waiting, use the free Regenerate Thumbnails plugin or the WP-CLI command wp media regenerate. The WP-CLI documentation for media regenerate lists its options.
If new sizes never appear, the server may not be creating them at all. Our guide on fixing thumbnails not generating covers that problem.
Stuck background tasks are covered in fixing past-due Action Scheduler actions.
What size should product images be?
Upload product images at least as wide as your largest display size, and ideally around twice that width, so they stay sharp on high-density screens and when zoomed.
Many stores upload square images between 1,000 and 2,000 pixels wide. That leaves room for the product page, zoom features and future layout changes.
Use the same aspect ratio for every product photo. Consistent shapes keep shop grids neat, whatever cropping setting you choose.
Compress images before or after upload so pages stay fast. Our guide on how to properly size images in WordPress covers sizing and file weight together.
Should you test image size changes before going live?
Yes, test image size changes on a staging copy first, because they affect every product page, every grid and every image file on the server.
A new size can change how many products fit in a row, how tall cards are and how the mobile layout looks. Those changes are easier to judge on a copy of the store than on the live site.
Regenerating images also creates new files for every product. On a large store this uses disk space and server time, so it is better to settle the final sizes in one go.
Take a backup before you start. Our guide on backing up a WooCommerce store covers files and the database.
Check the results with real devices, too. The web.dev guide to image performance explains how image dimensions affect loading, which helps you balance sharpness against page speed.
Why do product images still look wrong after the change?
If images still look the same, clear your caches; if they look blurry or stretched, the uploaded originals may be too small or the theme may be scaling them with CSS.
Clear your caching plugin, server cache and CDN, then check the page in a private window. Old image sizes often remain cached for a while.
Blurry product images usually mean the source files are smaller than the new display size. Our guide on fixing blurry WooCommerce images covers the causes in detail.
Stretched or squashed images point to CSS in the theme. Inspect the image in your browser and look for fixed heights or widths that do not match the image's ratio.
If products disappear from the shop after layout changes, see our guide on products not showing on the shop page.
Frequently asked questions
What is the best image size for WooCommerce products?
There is no single best size, but square images between 1,000 and 2,000 pixels wide suit most stores. They leave room for zoom and high-density screens. Keep the same aspect ratio across all product photos so shop grids look consistent.
Why are the WooCommerce Product Images settings missing?
Your theme probably declares its own image widths, which hides the Customizer fields, or you are using a block theme without the Customizer in the menu. Check the theme's settings panel or edit the product image blocks in the Site Editor.
How do I stop WooCommerce cropping product images?
In the Product Images section of the Customizer, set Thumbnail cropping to Uncropped and publish. Your catalog images will then keep their original shape. Expect uneven grid rows if your product photos have different aspect ratios.
Do I need a plugin to resize WooCommerce images?
No. WooCommerce has built-in settings and regenerates images in the background. A plugin such as Regenerate Thumbnails is only useful if background regeneration stalls or you want to rebuild all sizes at once.
Sources
- Image sizes for theme developers WooCommerce
- WooCommerce Customizer WooCommerce
- Regenerate Thumbnails WordPress.org Plugins
- wp media regenerate WordPress Developer Resources
- Site Editor WordPress.org Documentation
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


