WooCommerce Docs

Documentation, Reference Materials, and Tutorials for your WooCommerce products


Adding product images and galleries

Featured image ↑ Back to Top

The Featured Image is the main image for your product. It is displayed in your product loops (i.e., product categories, up sells, related products, etc.) and serves as the focus in the image gallery of your product details page.


Adding the featured image

Add product galleries ↑ Back to Top


Product galleries display all images attached to a product through the Product Gallery meta box.

You can create a product gallery using the same method as adding a featured image, but using the Product Gallery meta box.

Reorder and remove images from product galleries ↑ Back to Top

Images in the product gallery can be re-ordered easily via drag and drop. Simply re-order your images by moving them around.

To remove an image from the product gallery, hover over the image and click on the red “x”.

Image dimension settings ↑ Back to Top

On the catalog tab at WooCommerce > Settings > Products > Display > Product Images, there are three image dimension inputs. Note that the first number is width and the second height.

Product Images

  • Catalog Images appear in shop loops, such as product categories, up-sells/cross-sells.
  • Single Product Image is the main image on your product details page
  • Product thumbnails are the (optional) gallery thumbnails on your product details page.
  • The Product Image Gallery lightbox will create a pop-up window with all product images (including the featured image)


The images you upload are resized to match the values you input. For example, if your settings are 100×100 and you upload a 300×600 image it is resized to 100×200. You can also choose to ‘hard crop’ your images, which forces them to be the size specified in the settings, regardless of the raw image you upload, so they’re cropped rather than distorted in scale.

If you change settings after uploading product imagery, you need to regenerate thumbnails within WordPress for the changes to apply. To do this, we recommend using the Regenerate Thumbnails plugin.

Define custom image dimensions in a bespoke theme

If you’re building a custom theme, you may want to configure these settings automatically. Use the snippet at: Set Image Dimensions in a Custom Theme.

Back to the top