Adding Product Images and Galleries

Images are measured and set in pixels, for example: 800 x 800 pixels. Note that the first number is width and the second is height.

We recommend organizing your images in a folder offline and keeping a backup in case you need them in the future or mistakenly alter one and wish to revert to the original.

Types of images ↑ Back to top

WooCommerce uses three types of Product Images for different locations and purposes:

  • Single Product Image is the largest image and refers to the main/featured image on your individual product details page.
  • Catalog Images are medium-sized images appearing in product loops, such as the Shop page, Product Category pages, Related products, Up-sells, and Cross-sells.
  • Product thumbnails are the smallest images used in the Cart, Widgets, and (optional) Gallery thumbnails underneath the Single Product Image.

Adding Product Images and Galleries ↑ Back to top

Adding product images and galleries are options available on the right-hand side when adding or editing a product in your store from WooCommerce > Products.

Product image ↑ Back to top

The Product Image is the main image for your product and is reused in different sizes across your store.

Select Set Product Image.

Select an existing image in your Media Library or Upload a new one.

Remove and Edit the product image if you’d like to change it, as needed.

Adding, removing and editing a product image is done in the same way as featured images for posts and pages.

Product galleries ↑ Back to top

Add images to product gallery ↑ Back to top

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

Create a Product Gallery using the same method as adding a Product Image, but using the Product Gallery meta box.

Reorder images in product gallery ↑ 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.

Remove images from product gallery ↑ Back to top

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

Customer view ↑ Back to top

Once a product image and gallery have been added, customers can see them in your store.

It’s also possible to Zoom and see a closeup of the image by hovering over it.

Or customers can click the Magnifying Glass+ option in the upper right corner.

And a Lightbox pops up so customers can see a highlighted closeup of the image against a dark background and, if there is one, view the Gallery as a slideshow.

Touch gestures also work on mobile.

FAQ ↑ Back to top

What is the ideal image size to use with WooCommerce? ↑ Back to top

We recommend a minimum size of 800 x 800 pixels, width and height. This renders well for the main/featured image, catalog image and thumbnail image. Images that are larger are even better, especially if you’re selling items with great detail.

It’s possible to use images of lower resolution. However, your images are a key tool in selling and promoting your products and services online, so they should be of high quality.

My images are blurry/fuzzy, how do I fix them? ↑ Back to top

Have a look at: Fixing blurry product images.

What is Lightbox? ↑ Back to top

Lightbox is a feature that opens your image or images against a dark backdrop, shining a light on them, similar to a photo lightbox.

Can I turn off Lightbox? ↑ Back to top

Yes, but this is a customization, and we do not offer help with this under our Support Policy. See: Disable WooCommerce 3.0x Lightbox.

What is Zoom? ↑ Back to top

Zoom is a feature

Can I turn off Zoom? ↑ Back to top

Yes, but this is a customization, and we do not offer help with this under our Support Policy. See: Disable WooCommerce 3.0x Zoom.

How do I set image dimensions in a custom theme? ↑ Back to top

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

I don’t see the Product Images settings described in WooCommerce Customer above. ↑ Back to top

This might occur for two reasons:

  • You’re using a version of WooCommerce lower than 3.3x.
  • Your theme has declared support for a specific image size. This can be undone by using the code given under Theme Support at: WooCommerce Image Improvements.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top