Flex Gallery

Display a collection of media images or a WooCommerce product gallery in Flex, Grid, or Tiles layouts. Configure the thumbnail arrangement and optional image links/lightbox without building one image loop manually.

Setup and First Use


Before starting, enable the relevant element or feature family under Bricks → BricksUltimate → General Elements, save, and reopen the Bricks editor. Integrations also require their corresponding plugin to be active.

  1. Add (BU)Flex Gallery and choose Source: WP Media or WooCommerce Gallery.
  2. For WP Media, select the gallery assets. For WooCommerce Gallery, use a product page/template with the correct product context.
  3. Decide whether to exclude the featured product image and whether the first image should cover the full width.
  4. Choose Grid type, columns, thumbnail resolution where available, aspect ratio, minimum width, alignment, and image spacing.
  5. Choose Link to and the available lightbox library/options if images should open larger.
  6. Style opacity and hover behavior, save, and test images, captions, and navigation on desktop and mobile.

Controls and Settings


ControlPurpose and usage
SourceWP Media uses selected assets. WooCommerce Gallery reads the current product gallery.
Exclude featured imageRelevant to the WooCommerce source. Avoid displaying a duplicate lead image if another product image is already above the gallery.
First image cover the full width?Creates a lead-image arrangement before the remaining thumbnails.
Update with variation image?Available for a full-width first image with the WooCommerce source. Follow the selector setup described below.
Grid type / ColumnsChoose Flex, Grid, or Tiles, then configure the exposed column and spacing controls.
Link / LightboxSelect the intended link behavior, image size, captions, alt display, thumbnails, and thumbnail position for the chosen library.

Connect Variation Images


For the variation-update option, the element description instructs you to use .update-with-variations in the Add To Cart element's Swatches section under the (BU)Product Image element selector. Enable the full-width first-image option and WooCommerce source before testing. Select several variations and reset the form; do not assume a standalone gallery automatically synchronizes every variation plugin.

Image Preparation and Lightbox Content


Use appropriate thumbnail sizes and meaningful media alternative text/captions. Large originals should be reserved for a lightbox when needed, not downloaded for every small thumbnail. Configure one lightbox behavior and test grouping; overlapping lightbox libraries can attach competing click handlers.

Practical Example


Create a product gallery with one large first image and a grid of smaller images below it. Enable variation image updates, connect the documented swatches selector, and test a variation with its own image.

Troubleshooting


  • Empty Woo gallery: preview a real product and check its image assignments.
  • Unexpected cropping: review aspect ratio and image framing.
  • Variation image unchanged: confirm the source, full-width first image, update toggle, and Add To Cart selector.
  • Lightbox opens twice: remove a competing lightbox configuration.

Related Documentation