WooCommerce product image size: defaults and crop settings

WooCommerce shows product images 600 px wide uncropped, grid thumbnails 300 px wide cropped square, and gallery thumbnails at 100×100 by default.

5 min readSume
All posts

WooCommerce product image size: by default the single product page shows the image uncropped at 600 px wide, product grids such as the shop page show it at 300 px wide cropped square, and gallery thumbnails are 100 × 100 px square. A square product photo at least 600 px wide, with the product centered, shows whole in all three.

WooCommerce's defaults are quoted from its developer docs page Image sizing for theme developers, read on 2026-09-29; that page was written for classic themes, and block themes have their own document. Sume facts come from the Image API docs and the Sume API reference.

What are WooCommerce's default image sizes?

WooCommerce registers three image sizes. They set the files it generates; your theme can still display images at other sizes with CSS, and grid column widths can limit them.

From WooCommerce's Image sizing for theme developers, read 2026-09-29.
Size nameUsed forDefault
woocommerce_singleMain image on the single product page600 px wide, uncropped (the image as uploaded)
woocommerce_thumbnailProduct grids, such as the shop page300 px wide, square cropped
woocommerce_gallery_thumbnailSmall images below the main image, to switch the gallery100 × 100 px, always square cropped

How do I change the WooCommerce product image size?

In the customizer, the store owner picks one of three cropping settings for catalog images: 1:1 (square), Custom (an aspect ratio you enter) or Uncropped (keeps each image's own ratio), plus the widths. Things to know:

  • If your theme declares image sizes, the width fields are hidden and only the cropping option shows.
  • Changes reach customers only after you publish the customizer and the thumbnails are regenerated to the new dimensions.
  • Developers can change a size with the woocommerce_get_image_size_{size} filter, but WooCommerce doesn't recommend that route for plugins and themes because it overrides the store owner's settings.

What size should I upload product images?

Upload one square image per photo, larger than 600 px. By default the product gallery uses WordPress's full image size when shoppers zoom or view the full-size image, so the extra pixels are not wasted. Keep the product centered with some space around it, so a custom crop ratio chosen later doesn't cut it off. Use the same ratio for every product so the grid lines up.

How do I make square product images with AI?

Start from your real product photo. ChatGPT Image 2.5 (openai/gpt-image-2.5) on Sume takes an exact custom image_size with edges in multiples of 16, so it can render any square from 816 × 816 to 2880 × 2880. Send your photo at a public HTTPS URL in input_references and ask for the same product on a plain square background. An edit re-renders the image, so check that the product is unchanged.

Two other routes: cut the product out with background removal (POST /v1/rmbg-1.0/remove, $0.0225 per image) and place it on a square canvas yourself, or enlarge a small photo with Image Upscale (POST /v1/image-upscale-1.0/upscale, up to 4×, $0.20 per image). /v1/images results come back as signed, Sume-hosted URLs: download the files and add them to your WordPress media library.

Sources

Related posts

More in Media tools

All Media tools posts

Written by Sume