Skip to main content
Sign in with your store to see only the help that applies to you.

Product Image Gallery

Admin

Use this page to add several photos to a product so customers can flip through them on its storefront page.

Quick steps​

  1. Go to Products and click the product to open it.
  2. On the Details tab, open Product Images (Optional).
  3. Set the main photo with Upload Image File (or paste an Image URL, or scan the Upload from Phone code).
  4. To add more photos, choose one or more files in Additional Images.
  5. Click Update Product. On the storefront, the product page shows the main photo large with a strip of thumbnails underneath.

Common questions​

Which file types can I use? JPEG, PNG or WebP, each 5 MB or smaller. GIFs are rejected.

How do I remove a photo? Hover over it under Current Images and click the bin icon. It's removed straight away.

Can I change the order of the photos? No. The main (primary) photo always comes first.

Why do menu cards show only one photo? Cards show only the main photo. The other photos appear on the product page.

More detail: how the gallery displays

On a storefront product page:

  • The main image is shown large. It is the product's primary image.
  • If the product has more than one image, a thumbnail strip shows all of them, primary image first.
  • Customers click a thumbnail to show it as the main image.
  • A product with no image shows a placeholder icon.

On product cards (category pages, search results and menus), only the primary image is shown. The other images appear only on the product page.

The thumbnail strip includes the images you upload in Additional Images, followed by any extra images that came in as web addresses (for example from a WooCommerce sync or a product import).

More detail: adding images, formats and managing images

Adding Images to a Product​

  1. Go to Products and click the product to open it.
  2. On the Details tab, open Product Images (Optional).
  3. Set the primary image with Upload Image File, or paste a web address into Image URL. You can also scan the Upload from Phone QR code to take the photo with your phone.
  4. To add more images, choose one or more files in Additional Images.
  5. Click Update Product.

See Product Images for every way to add a photo.

Supported Formats​

FormatNotes
JPEG (.jpg, .jpeg)Best for product photos. Good balance of quality and file size.
PNG (.png)Best for images with transparency or sharp text and logos.
WebP (.webp)Small files with good quality.

Each image must be 5 MB or smaller. Other formats, such as GIF, are rejected when you save.

Keep images light

Large images slow down your storefront. Square photos around 1200 x 1200 pixels look sharp without making pages slow.

Managing Images​

Existing images are shown under Current Images on the Details tab, with the primary image marked Primary.

  • Remove: Hover over an image and click the bin icon. Confirm, and the image is removed straight away — you don't need to click Update Product.
  • Replace the primary image: Upload a new file in Upload Image File or paste a new Image URL, then click Update Product.

There is no way to change the order of gallery images.

More detail: turning product photos off

Turning Product Photos Off​

To hide product photos across your whole storefront, open the storefront editor, go to Domain & More, and untick Show next to Product Images. It is on by default.

What's Next?​

  • Product Reviews — Let customers review products on product pages.
  • Product Images — All the ways to add and manage product photos.
  • Storefront — Overview of storefront setup and configuration.