BloomStack Gallery Spotlight for WooCommerce

By Bloom Stack

★ 5.0/5 (1 ratings)0+ active installationsVersion 1.13.0

Create a WooCommerce product gallery with video, variation images, flexible thumbnails, and a fullscreen lightbox.

Description

Give shoppers a closer look at your products with a flexible WooCommerce image and video gallery. Combine product photos with YouTube, Vimeo or self-hosted videos, choose your thumbnail layout, and open images and videos in a fullscreen lightbox.

Let shoppers browse variation image collections before choosing an option. Customise gallery controls, colours and video playback in WooCommerce settings.

Explore Gallery Spotlight on Bloom Stack for more screenshots and feature details.

Compatibility: Designed for classic WooCommerce single-product pages. Product Gallery blocks and quick-view modals keep their native galleries. Requires WooCommerce 8.0 or later.

Make your products easier to explore

  • Photos and video together — Add YouTube, Vimeo or self-hosted video with custom posters. YouTube and Vimeo also support automatic thumbnails. Set autoplay, mute, looping and video controls per product. Enabled WooCommerce native videos are also included in the parent gallery.
  • Browse variation image collections — Let shoppers explore a variation’s photos before selecting it for purchase, with clear Select and Selected controls. Reset the selection to return to the parent gallery.
  • Keep product images in focus — Keep gallery controls visible, reveal them on hover, or dim them between interactions. Adjust idle opacity from 10–90%, defaulting to 30%. Controls stay visible during keyboard navigation and on touch devices.
  • Match your storefront — Set the active thumbnail border, collection and Select button backgrounds, and separate action and navigation hover colours. Adjust arrows, counters, pagination dots, spacing and looping.
  • Flexible thumbnail layouts — Place thumbnails on the left, right or below the image. On mobile, thumbnails sit below the image and can be hidden.
  • A closer look in the lightbox — Open images and videos in a fullscreen viewer with keyboard navigation.

Getting started

  1. Install and activate Gallery Spotlight alongside WooCommerce.
  2. Open WooCommerce → Gallery Spotlight to choose a layout and gallery controls.
  3. Edit a product, open its Gallery Spotlight tab, and add a video URL and optional poster image.
  4. View the product on your storefront to try the gallery and lightbox.

Theme and developer details

On supported classic product pages, Gallery Spotlight owns and replaces the WooCommerce gallery for every non-excluded product type. Product types can be excluded in the plugin settings.

A variation with its own media shows a separate collection; parent images and videos are not mixed into that collection. Resetting the selection, or selecting a variation that falls back to the parent, restores the parent gallery. Enabled WooCommerce native videos are read from the parent product without changing WooCommerce’s media metadata.

Themes can override the gallery markup by copying templates/frontend/gallery.php to yourtheme/gallery-spotlight/gallery.php. The gallery_spotlight_locate_template filter can change the path.

Third-Party Services

This plugin connects to YouTube or Vimeo when their videos are configured for a product.

  • YouTube: the IFrame Player API (https://www.youtube.com/iframe_api) loads on supported product pages with a YouTube video. Inline embeds use youtube-nocookie.com and load when their slide becomes active; the lightbox also uses privacy-enhanced embeds. Default thumbnails load from i.ytimg.com unless a custom poster is set. These requests share normal browser request data with Google/YouTube; privacy-enhanced mode does not eliminate third-party connections. See YouTube Terms and Google Privacy Policy.
  • The Vimeo Player SDK (https://player.vimeo.com/api/player.js) is loaded only on single-product pages whose product has a Vimeo video. Loading the SDK or a Vimeo iframe connects the visitor’s browser to Vimeo, which receives normal request data such as IP address and user agent.
  • After a Vimeo product URL is saved without a custom poster, an asynchronous WordPress cron job sends that saved URL to Vimeo’s oEmbed API to request its thumbnail. Vimeo receives the URL and normal server request data. Successful responses are cached locally for 24 hours and failed requests back off before retrying; frontend rendering never initiates this oEmbed request.
  • Direct-video files load from the URL configured by the site administrator. If that URL uses a third-party host, the visitor’s browser connects to that host under its terms and privacy policy.

Vimeo service terms:

Bundled Open-Source Libraries

Libraries are bundled locally; source code and MIT licences:

Installation

  1. Upload the bloomstack-gallery-spotlight-for-woocommerce folder to wp-content/plugins/.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Ensure WooCommerce is installed and active.
  4. Go to WooCommerce → Gallery Spotlight to configure global settings.
  5. Edit any product and use the Gallery Spotlight tab in the product data panel to add a video URL and configure playback options.

FAQ

What video formats are supported?

HTTPS YouTube and Vimeo URLs and direct HTTP(S) MP4/M4V, WebM, Ogg/Ogv, and MOV file URLs are supported. YouTube watch, youtu.be, Shorts, live and embed links are supported; playlists are not. Paste the standard Vimeo URL (e.g. https://vimeo.com/123456789) or the direct URL to the video file. MOV/QuickTime playback depends on browser and codec support; MP4 or WebM is recommended for broad compatibility.

Does it work with variable products?

Yes. Shoppers can browse variation photos without changing the purchase selection, then use Select to choose that variation. Each collection contains the variation’s own images; parent images and videos are not mixed into that collection. Resetting the selection restores the parent gallery.

Does it replace WooCommerce Product Gallery blocks?

No. WooCommerce Product Gallery blocks remain native and unsupported.

How are WooCommerce native videos handled?

Enabled, readable WooCommerce native videos appear in the parent gallery on classic product pages. Gallery Spotlight does not change their WooCommerce metadata.

Can I use any YouTube video?

Videos must allow embedding. Private, age-restricted, region-restricted or embedding-disabled videos may not play. Playback starts at the beginning; URL timestamps and playlist parameters are not imported. Autoplay depends on browser policy.

Can I hide or dim the gallery controls?

Under WooCommerce → Gallery Spotlight → Navigation, choose Always visible, Show on hover or Dim until hover. Dim mode has an Idle opacity slider, defaulting to 30%. Mouse clicks do not keep controls visible after the pointer leaves; keyboard navigation does. Touch devices keep controls fully visible. This setting affects gallery navigation and collection controls, not video playback controls.

Can I control video playback?

Yes. Each product has individual settings for autoplay, loop, mute, and show/hide video controls. These settings apply to both the inline gallery player and the lightbox.

How does it affect page speed?

The first image loads eagerly with high priority and a preload hint; later images use browser-native lazy loading. Gallery scripts load only on supported single-product pages. YouTube and Vimeo player scripts load only when the relevant video is present. YouTube inline embeds load when their slide becomes active.

Screenshots

Changelog

1.13.0

  • Added YouTube video support alongside Vimeo and self-hosted videos, with automatic thumbnails and fullscreen playback.
  • Added Always visible, Show on hover and Dim until hover control visibility modes, plus adjustable idle opacity defaulting to 30%.
  • Kept controls visible for keyboard navigation and touch, while allowing them to dim after mouse clicks when the pointer leaves.
  • Added separate Select button and navigation hover colours, a pale lavender Select default, and clearer global colour-setting names.
  • Redesigned the product video panel and shortened its tab name to Gallery Spotlight.
  • Improved collection controls with smooth resizing, fading labels and corners matching the navigation controls.

Older release history is preserved in changelog.txt.