When to use it

Use Gallery when several visual blocks belong to one section and need a shared heading plus a repeatable layout rhythm. It works for image collections, grouped campaign cards, and editorial grids that mix several child block types.

If the children are specifically LinkBlock tiles in a horizontal browsing row, GalleryWithLinkBlocks is the more opinionated choice.

Composition notes

Gallery is a wrapper component. You bring the children and choose the layout:

• variant="grid" is the balanced default.
• variant="masonry" gives uneven image sets a looser editorial feel.
• variant="filmstrip" pushes the layout toward a horizontal sequence.
• heading adds section framing above the children.

Because children are free-form, keep one visual language per gallery. Mixing too many card shapes usually makes the section feel noisy.

Behavior and theming guidance

Use the heading only when the gallery needs section framing. If the surrounding page already provides a clear heading, the wrapper can stay visual and simple.

Spacing comes from the gallery recipe, so prefer choosing the right variant before manually forcing lots of item-level margin tweaks.