Docs

Product Images

The product image and gallery: WooCommerce's slider with thumbnails, zoom and lightbox, or every image in a grid.

On this page

The Product Images widget shows the main image of a WooCommerce product and the images of its gallery. Place it in the left column of your product page template. Choose WooCommerce's own gallery, with a slider, thumbnails, zoom and a full-screen view, or show every image at once in a grid or a single column.

A large product image with a Sale! badge in the top left corner and a magnifier button in the top right corner, above a row of four thumbnails
Gallery with thumbnails below the image, with Sale badge turned on.

Where the product comes from

The widget shows the product being viewed: on a product page template it is the product the visitor opened, and in a product loop item it is each card's product. To show one particular product anywhere else, pick it in the Product section of the Content tab.

The images are the Product image and the Product gallery you set when you edit the product in WooCommerce. A product without images shows WooCommerce's placeholder image.

Add Product Images

Open your product page template in the Theme Builder. Then click Insert in the rail on the left, find Product Images in the WooCommerce group (or type "gallery" in the search box) and drag it into the template. See Add elements.

Choose a layout

  • Gallery with thumbnails (default) is WooCommerce's gallery: one large image with a row of thumbnails below, or a column of them on the left or right. Visitors zoom by hovering the image, swipe between images, and open them full screen with the button in the corner. The notice in the settings reminds you that zoom, the full-screen view and sliding come from WooCommerce and work on the site and in Preview.
  • Grid shows every image at once, in 1 to 4 columns. First image full width makes the main image span the whole row.
  • One column stacks every image under each other, a common layout beside a sticky product summary.

In Grid and One column, each image opens in the lightbox when Open image links in the lightbox is on in the Design System (it is by default). See Lightbox & site behaviour.

When a shopper picks the options of a variable product, such as a color, WooCommerce shows that option's image: as the large image of the gallery, or as the first image of the grid or column.

Once a Single product template is live, the gallery's zoom, full-screen view and slider are on, whatever your theme declares.

Show a sale badge

Turn on Sale badge to show a badge on the image while the product is on sale. It reads Sale! unless you type your own Badge text. In the editor the badge also shows on products that are not on sale, so you can style it. To show the discount in percent or a "Sold out" badge, use the Sale Badge widget instead.

Content tab settings

Content tab · Images
SettingWhat it does
LayoutGallery with thumbnails, Grid or One column. Default: Gallery with thumbnails.
ThumbnailsWhere the thumbnails sit: Below, Left or Right. Default: Below. Gallery only.
Thumbnails per row2–8. Shown when the thumbnails are below the image. Can differ per device.
Columns1–4. Grid only. Can differ per device.
First image full widthThe first image spans the whole row. Grid only.
Sale badgeA badge on the image while the product is on sale. Off by default.
Badge textThe badge's text. Default: Sale!. Shown when Sale badge is on.
Content tab · Product
SettingWhat it does
ProductLeave empty to show the product being viewed (product pages, product loop items). Pick a product to show it on any page.

Design tab settings

Design tab
SectionSettings
ImagesGap, Border radius and Background of the images. For the gallery, under Thumbnails: Column width (thumbnails on the left or right), Border radius, Opacity of the others (the thumbnails that are not shown, 0.1–1) and Current thumbnail outline; under Full-screen button: Icon color and Background.
Sale badgeTypography, Text color, Background, Border radius and Position (Top left or Top right). Shown when Sale badge is on.

The badge takes the colors of Design System → Shop → Sale badge until you change them here. See Shop styles. The Design tab also has the sections every element shares: Spacing & position, Background & border and Mask. See Spacing, size & position.

Behaviour tab

The Behaviour tab has the settings every element shares: anchor and classes, entrance animations, motion effects, visibility per device, display conditions and interactions. See Visibility.

Tips

  • Upload product images with the same proportions, for example all square. The gallery then keeps the same height from image to image.
  • With One column, make the summary column beside it sticky (Behaviour → Motion & effects → Sticky), so the price and Add to Cart stay in view while visitors scroll the images. See Make an element sticky.