All docs

Brand Story

Gallery

Section handle: gallery

Settings

Layout

SettingTypeDefaultDescription
LayoutDropdowngridGrid shows uniform rows/columns. Mosaic uses masonry layout. Strip scrolls horizontally. · Options: grid – Grid, mosaic – Mosaic, strip – Strip
Columns (desktop)Number4Number of columns on desktop screens.
Columns (mobile)Number2Number of columns on mobile screens.
Aspect ratioDropdown1_1Applied to grid and strip variants. Mosaic always uses natural ratios. · Options: 1_1 – Square (1:1), 4_5 – Portrait (4:5), 3_2 – Landscape (3:2), natural – Natural
SpacingDropdownmediumControls the gap between gallery images. · Options: tight – Tight, medium – Medium, wide – Wide
Caption styleDropdownbelowHow captions are displayed. Overlay styles appear on top of the image. · Options: below – Below image, overlay_bottom – Overlay (bottom), overlay_center – Overlay (center)
Hover effectDropdownnoneDesktop only. Disabled when user prefers reduced motion. · Options: none – None, zoom – Zoom, lift – Lift
Enable lightboxToggle (on/off)OffOpens a full-screen viewer when an image without a link is tapped.

Style

SettingTypeDefaultDescription
Padding topDropdownmediumOptions: none – None, small – Small, medium – Medium, large – Large
Padding bottomDropdownmediumOptions: none – None, small – Small, medium – Medium, large – Large

Blocks

Image

Block type: image

Content

SettingTypeDefaultDescription
ImageImageSelect an image to display.
CaptionTextOptional. Leave blank to hide.
LinkURL / LinkOptional. Leave blank to disable.
FeaturedToggle (on/off)OffFeatured images span two columns in grid layout.

Default Configuration

When you add this section from the Theme Editor, it comes pre-configured with:

  • Gallery — 1× Image