Skip to main content
Version: Beaver Builder 2.11

Gallery

Use Gallery to display multiple photos in a collage or grid layout with optional captions, lightbox, and SmugMug support.

Usage​

Use Gallery to display multiple photos in a single module using either a Collage layout that arranges photos at varied widths or a Thumbs layout that renders uniform thumbnails. Photos can come from the WordPress media library or a SmugMug RSS feed, and each image can open in a built-in lightbox, link to its full-size source, or render without a click action. Captions read from the WordPress media manager or the SmugMug feed and can show on hover or below each photo.

Use Gallery on portfolio pages, event recaps, product showcases, and any layout that needs to present a curated set of images without building a custom grid by hand. It fits straightforward image-collection workflows where photo selection, layout, and click behavior need to stay simple.

Module Settings​

The Gallery module settings control which photos appear, how the gallery is laid out, what happens when a photo is clicked, and the spacing and border applied to each image.

General Tab​

The General tab selects the layout, photo source, photos, captions, and click behavior.

Layout Default: Collage

Sets how photos are arranged in the gallery.

  • Collage: Arranges photos at varied widths in a masonry-style layout and reveals the Photo Size field.
  • Thumbs: Renders photos as uniform thumbnails based on the WordPress thumbnail size.
Source Default: Media Library

Selects whether photos come from the WordPress media library or a SmugMug RSS feed.

  • Media Library: Pulls images from the WordPress media library and reveals the Photos field.
  • SmugMug: Pulls images from a SmugMug gallery RSS feed and reveals the Feed URL field. The RSS feed URL can be accessed by using the get a link function in your SmugMug gallery.
Media Library Settings
Photos Supports: Field Connections

The set of photos selected from the WordPress media library. This field appears when Source is set to Media Library.

SmugMug Settings
Feed URL Supports: Field Connections

The SmugMug gallery RSS feed URL used to load photos. This field appears when Source is set to SmugMug.

Photo Size Default: Medium

Sets the rendered photo width used for the Collage layout. This field appears when Layout is set to Collage.

  • Small: Renders photos at approximately 200px wide.
  • Medium: Renders photos at approximately 300px wide.
  • Large: Renders photos at approximately 400px wide.
Show Captions Default: Never

Controls whether photo captions display and where they appear. Captions read from the caption field in the WordPress media manager, or directly from the SmugMug feed when SmugMug is the source.

  • Never: Hides photo captions.
  • On Hover: Shows the caption as an overlay when a photo is hovered.
  • Below Photo: Shows the caption beneath each photo.
Click Action Default: Lightbox

Selects what happens when a visitor clicks a photo.

  • None: Disables the click action so photos are not clickable.
  • Lightbox: Opens the photo in the built-in lightbox and reveals the Lightbox Photo Size field.
  • Photo Link: Links each photo to its full-size image URL.
Lightbox Settings
Lightbox Photo Size Default: Large

Sets the WordPress image size used when a photo opens in the lightbox. This field appears when Click Action is set to Lightbox.

Style Tab​

The Style tab controls the spacing between photos and the border applied to each photo.

Photo Spacing Default: 20

The space, in pixels, between photos in the gallery.

Photo Border Supports: Responsive

The border style, width, color, and radius applied to each photo, plus an optional box shadow.

Advanced tab​

The Advanced tab includes all the standard settings for margins, visibility, animations, and advanced HTML configurations.

See the Advanced tab section for more information.