Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

WooCommerce · Guide

How to Resize Product Image in WooCommerce (Step by Step)

How to Resize Product Image in WooCommerce (Step by Step)

Short answer

Go to Appearance, then Customize, then WooCommerce, then Product Images. Set the main image width, the thumbnail width and the thumbnail cropping, then click Publish. WooCommerce regenerates images in the background, or you can run Regenerate Thumbnails to update older product photos.

Key takeaways

  • WooCommerce uses single, thumbnail and gallery thumbnail image sizes.
  • Change sizes under Customize, WooCommerce, Product Images.
  • Thumbnail cropping can be square, a custom ratio or uncropped.
  • Some themes fix image widths, which hides the width fields.
  • Regenerate images and clear caches after changing sizes.
  • Upload large images at one consistent aspect ratio.

How do you resize product images in WooCommerce?

Go to Appearance, then Customize, then WooCommerce, then Product Images, set the main image and thumbnail widths and the cropping, publish, and let WooCommerce regenerate the images.

WooCommerce does not show your original upload on product pages. It creates smaller copies at set sizes and displays those.

Changing those sizes is how you make product photos larger, smaller, square or uncropped across the whole store.

This guide covers the Customizer settings, theme-defined sizes, block themes, regenerating old images and code options for developers.

Which image sizes does WooCommerce use?

WooCommerce uses three main sizes: a single image for the product page, a thumbnail for shop and category grids, and a small gallery thumbnail under the main image.

Each size has its own job. Knowing which one you need to change saves time.

Image sizeWhere it showsControlled by
woocommerce_singleMain image on the single product pageMain image width setting
woocommerce_thumbnailShop, category and related product gridsThumbnail width and cropping settings
woocommerce_gallery_thumbnailSmall images under the main product imageCode filter only

The WooCommerce image sizes documentation lists these sizes and their default behaviour.

WordPress also creates its own sizes, such as thumbnail, medium and large, for every upload. Our guide on how to properly size images in WordPress explains those core sizes.

Step 1: How do you open the product image settings?

From your dashboard, go to Appearance, then Customize, open the WooCommerce panel and click Product Images.

You will see a live preview of your store next to the settings. Browse to a shop page in the preview so you can watch the changes.

The WooCommerce guide to product page and product images in the Customizer shows this panel.

If you do not see a Product Images section, there are two usual reasons:

  • Your theme sets the image sizes itself, so WooCommerce hides some options.
  • You use a block theme, where the Customize link may not appear in the Appearance menu.

Both cases are covered below.

Step 2: How do you change the main product image size?

In the Product Images panel, type a new pixel value into Main image width and click Publish.

This controls the large image on each single product page. WooCommerce keeps the original shape of this image, so only the width is set.

Choose a width that matches how wide the image area is in your theme layout. A value much larger than the space wastes bandwidth, while a smaller value looks soft or blurry.

A simple way to check is to right click the image on a product page, inspect it, and look at the displayed width in your browser tools. Set the main width at or a little above that number.

If images still look blurry after resizing, our guide on how to fix blurry WooCommerce images covers other causes.

Step 3: How do you change thumbnail width and cropping?

Enter a value in Thumbnail width, then pick a cropping option: 1:1 for square, Custom for your own ratio, or Uncropped to keep each photo's original shape.

Thumbnails are the images in your shop grid, category pages and related products. They matter most for how tidy the store looks.

The cropping options work like this:

  1. 1:1 crops every thumbnail to a square. Grids line up neatly.
  2. Custom lets you set a ratio, such as 4:3 or 3:4, for landscape or portrait products.
  3. Uncropped keeps the original aspect ratio, so rows can have uneven heights if photos differ.

Cropping trims from the centre of the image. If your products sit off-centre in the photo, parts may be cut off, so check a few products after saving.

For a clean grid, take or edit all product photos at the same aspect ratio before uploading. That way no option has to crop much.

Step 4: How do you regenerate existing product images?

WooCommerce regenerates images in the background after you change sizes, but you can force it with a plugin such as Regenerate Thumbnails or the WP-CLI media regenerate command.

New sizes only apply to images that have a copy at that size. Old uploads need new copies made.

WooCommerce handles this automatically for most stores. The thumbnail regeneration documentation explains how background regeneration works and how to turn it off.

On large stores, the background process can take a while. If images still show the old size after some time, regenerate them yourself:

  • Plugin: install Regenerate Thumbnails and run it from Tools.
  • Command line: run wp media regenerate on the server.

The wp media regenerate command reference lists options such as regenerating only missing sizes.

Back up your site first on big catalogues. Our guide on how to back up a WooCommerce store shows simple ways to do that.

After regenerating, clear any page cache and CDN cache so visitors get the new files.

Why can't you change the image width in the Customizer?

Your theme has declared its own WooCommerce image widths, which hides the width fields so the theme's layout stays consistent.

Themes do this with add_theme_support( 'woocommerce' ) and settings such as thumbnail_image_width and single_image_width.

When a theme sets these, you can usually still change the cropping ratio. The widths are fixed by the theme designer to match the layout.

To change them anyway, you have three choices:

  1. Check the theme's own settings panel, since many themes offer image options there.
  2. Ask the theme developer whether a supported setting exists.
  3. Override the values in a child theme with code, covered in the developer section below.

WooCommerce's article on how to set product image widths in a theme explains this behaviour from the theme side.

How do you resize product images with a block theme?

In block themes, open Appearance, then Editor, edit the Single Product or Product Catalog template, and adjust the product image blocks, while image file sizes still follow WooCommerce's settings.

Block themes build product pages with WooCommerce blocks rather than PHP templates. Those blocks have their own display controls.

For example, the product image blocks in a product grid let you choose how the image fits its box and, in some cases, the aspect ratio. These change how the image is displayed, not the files WooCommerce generates.

If you need the Customizer's Product Images panel, some block theme setups still reach it at the customize.php address in your admin area. Check your theme documentation, because support varies.

Our guide on how to customize WooCommerce pages covers editing these templates in more depth.

How do developers change WooCommerce image sizes in code?

Developers can set widths through add_theme_support( 'woocommerce' ) in a child theme, and change the gallery thumbnail with the woocommerce_get_image_size_gallery_thumbnail filter.

Here is an example that sets widths in a child theme's functions.php file:

add_action( 'after_setup_theme', function() {
    add_theme_support( 'woocommerce', array(
        'thumbnail_image_width' => 400,
        'single_image_width'    => 800,
    ) );
}, 20 );

The gallery thumbnail under the main image has no setting in the Customizer. A filter changes it:

add_filter( 'woocommerce_get_image_size_gallery_thumbnail', function( $size ) {
    return array(
        'width'  => 150,
        'height' => 150,
        'crop'   => 1,
    );
} );

Regenerate images after any code change so existing products get the new sizes. Put this code in a child theme or a small plugin, not the parent theme.

The image sizing guide for theme developers documents these options. Our guide on how to add code to WordPress explains safe places to put snippets.

What size should you upload WooCommerce product images?

Upload images larger than the biggest size your theme displays, all at the same aspect ratio, and compressed so they load fast.

WooCommerce can scale an image down cleanly but cannot add detail that is not there. A small upload stretched to fill a large space looks blurry.

Follow these simple rules:

  • Make the upload at least as wide as your main image width, and ideally wider for sharp screens.
  • Keep one aspect ratio for all products, such as square, so thumbnails crop evenly.
  • Centre the product in the frame with some empty space around it.
  • Compress images before or after upload to keep pages fast.

If your theme has a zoom or lightbox feature, the full-size upload is used for the zoomed view. That is another reason to upload a reasonably large file.

For compression and modern formats, see our guide on how to optimize images for WordPress.

Why are product images still the wrong size after changes?

The usual causes are images that have not been regenerated, a page or CDN cache serving old files, or theme CSS that stretches images to fit the layout.

Work through these checks:

  1. Regenerate images if the files on the server are still the old size.
  2. Clear every cache, including your caching plugin, host cache and CDN.
  3. Inspect the image in your browser. If the file is the right size but displays differently, theme CSS is resizing it.
  4. Check your page builder or product grid block, which may use its own image size setting.
  5. Check for image plugins that serve resized or converted copies from another location.

If thumbnails are not being created at all, our guide on fixing thumbnails that are not generating covers server and library problems.

Frequently asked questions

What are the default WooCommerce image sizes?

WooCommerce sets a main single product image, a catalog thumbnail and a small gallery thumbnail. The single image keeps its original shape, the catalog thumbnail is cropped square by default, and the gallery thumbnail is a small square. Your theme can change these defaults, so check the Customizer for your store's values.

How do I make all WooCommerce product images the same size?

Set Thumbnail cropping to 1:1 or a custom ratio in the Product Images settings, then regenerate images. For the best result, also upload all product photos at the same aspect ratio, so cropping does not cut off parts of some products.

Do I need to regenerate thumbnails after changing image sizes?

Usually WooCommerce does it for you in the background after you change sizes in the Customizer. On large stores this can take time. If images still show old sizes, run the Regenerate Thumbnails plugin or the WP-CLI media regenerate command, then clear your caches.

Why is the Product Images section missing in the Customizer?

Either your theme defines its own image widths, which hides some fields, or you use a block theme where the Customize link may not show in the menu. Check your theme settings and documentation, or set sizes in a child theme with code.

Will resizing product images affect page speed?

Yes, in either direction. Smaller display sizes mean smaller files and faster pages. Very large main image widths increase file size. Match sizes to your layout and compress images, and the store stays both sharp and quick to load.

Sources

  1. Image sizes WooCommerce Developer Docs
  2. Thumbnail image regeneration WooCommerce Developer Docs
  3. Product Page and Product Images WooCommerce
  4. Set product image widths in a WooCommerce theme WooCommerce
  5. Regenerate Thumbnails WordPress.org Plugins
  6. wp media regenerate WordPress Developer Resources

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.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.