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.
- Add (BU)Flex Gallery and choose Source: WP Media or WooCommerce Gallery.
- For WP Media, select the gallery assets. For WooCommerce Gallery, use a product page/template with the correct product context.
- Decide whether to exclude the featured product image and whether the first image should cover the full width.
- Choose Grid type, columns, thumbnail resolution where available, aspect ratio, minimum width, alignment, and image spacing.
- Choose Link to and the available lightbox library/options if images should open larger.
- Style opacity and hover behavior, save, and test images, captions, and navigation on desktop and mobile.
Controls and Settings
| Control | Purpose and usage |
|---|---|
| Source | WP Media uses selected assets. WooCommerce Gallery reads the current product gallery. |
| Exclude featured image | Relevant 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 / Columns | Choose Flex, Grid, or Tiles, then configure the exposed column and spacing controls. |
| Link / Lightbox | Select 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.