Slim Gallery

Create a compact justified image gallery with configurable row sizes and lightbox presentation. Choose selected WordPress media or the current WooCommerce product gallery.

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)Slim Gallery and select Source: WP Media or WooCommerce Gallery.
  2. Choose media images, or preview a real product with gallery images for the WooCommerce source.
  3. Set Show images to the intended visible count and decide whether to exclude the featured image.
  4. Configure row-height entries for the relevant Bricks breakpoints or a custom breakpoint.
  5. Choose Last row alignment and Gap, then configure alt/caption and lightbox thumbnails.
  6. Style the More button where applicable and test with more images than the visible limit.

Controls and Settings


ControlPurpose and usage
Source / Exclude featured imageSelected media and current product gallery use different data contexts; the featured-image toggle applies to the product source.
Show imagesLimits the initial gallery display. Confirm how the remaining images are reached in the lightbox with your chosen configuration.
Image widthControls the lightbox image size target, not the number of gallery columns.
Row height / BreakpointSet a target row height for each configured breakpoint. A justified row's actual arrangement depends on the source image aspect ratios.
Last row / GapControl the final row behavior and spacing between images.
Alt / Caption / ThumbnailsChoose which metadata and navigation aids appear in the lightbox, including thumbnail width.
More buttonCustomize the visible text, size, background, typography, border, padding, positioning, and transform.

Source Image Shape Matters


A justified gallery fits images of different proportions into rows. Do not expect the fixed-column behavior of a standard grid. Test a mix of portrait, landscape, and square assets, and choose row sizes that preserve recognizable subjects without overwhelming small screens.

Visible Count and Payload


A display limit is not proof that hidden originals are never referenced or downloaded. Optimize source files and inspect actual network usage for large collections. Provide descriptive media metadata and verify the lightbox's next/previous navigation and close control on touch and keyboard.

Practical Example


Build a travel gallery with several image proportions, show five images initially, and use smaller row-height values on mobile. Confirm visitors can open the gallery and reach the remaining images.

Troubleshooting


  • No product images: select the correct preview product and check gallery assignments.
  • Awkward last row: review Last row alignment and image proportions.
  • Breakpoint result differs: check saved breakpoint entries and test a real page reload at that width.
  • More button obscures content: adjust its spacing/position instead of enlarging the gallery blindly.

Related Documentation