Product Gallery Slider

Build a custom product image gallery using Bricks' Slider (Nestable) and the Product Galleries query type. Each loop item is an image attachment, not a product. You design one slide and repeat it for the gallery images.

Enable and Prepare


Activate WooCommerce and BricksUltimate, then reopen the Bricks editor. Product Galleries is registered as a separate query type when WooCommerce is active.

Edit the source product and set its Product image and Product gallery. For a variable product, assign variation images where needed. Open the single-product template with a real product selected for preview.

Controls and Behavior


ControlHow to use it
Query typeSelect Product Galleries directly in the main query Type selector. It is not an entry inside Woo query type. WooCommerce must be active.
Image sourceThe provider prepends the featured product image, then reads gallery images. Duplicate attachment IDs are removed.
Variation imagesAvailable variation images are appended only when the number of child variations is within the WooCommerce AJAX variation threshold, normally 30 but filterable by other code. Large variation sets do not receive the same automatic image expansion.
Slider controlsSlides per view, navigation, pagination, spacing, breakpoints, and movement belong to the Bricks slider, not to this image provider.
Image controlsChoose the image size, aspect ratio, object fit, and alternative text behavior on the Image element. Use consistent image ratios for stable slides.

Build the Repeated Slide

  1. Add a Slider (Nestable) in the single-product layout.
  2. Keep one slide Block and enable Use query loop on that slide, not on the entire slider.
  3. Choose Product Galleries as the query type.
  4. Add a Bricks Image inside the repeated slide. In its image source, use dynamic data for the current loop attachment. Bricks' Post ID tag, {post_id}, identifies that attachment; do not hard-code the parent product image.
  5. Choose an appropriate image size and configure navigation and responsive slide counts on the slider.
  6. Save and verify the rendered gallery on a real product page.

For a non-slider gallery, put the same image loop on a Block within a responsive grid. The provider supplies the same attachment list in either layout.

Practical Example


Create a one-image-per-view product gallery with arrows and pagination. Use a square image ratio and object-fit contain for product packshots. Populate a test product with a featured image and three different gallery images, then confirm the expected unique slides.

Scope and Limitations


This provider supplies images only. It does not automatically create a synchronized thumbnail slider, zoom, lightbox grouping, or variation-selection navigation. Configure those with supported image/slider features and test them separately. The shared Ultimate Woo Query Builder toggle is not the registration gate for this separate query type.

Troubleshooting and Testing


Repeated identical images usually mean the Image element reads the parent product rather than the loop attachment. An empty list can mean no image assignments or an invalid product preview. Missing variation images on large products may be the threshold behavior, not a broken slider.

Test the populated and empty states, desktop and mobile layouts, and any relevant AJAX refresh. Keep headings and decorative wrappers from leaving empty gaps when no eligible results exist. If a query type is missing, verify the feature toggle, WooCommerce activation, and editor reload before changing the layout.

Related Documentation