---
title: "CMS Masonry Lightbox"
canonical_url: "https://framerhub.io/components/cms-masonry-lightbox"
last_updated: "2026-11-09T16:24:41.652Z"
---

## Masonry Galleries from Your CMS

Turns a CMS collection into a masonry gallery with a lightbox and category filters, all set up in the properties panel. Use it for portfolios, product galleries and media libraries.

## Features

**Masonry layout.** Connect a CMS collection and the items lay out in a Pinterest-style grid, with 1 to 12 columns and your own gap.

**Lightbox.** Click an image or video to open it full screen. The component detects whether each item is an image or a video.

**Category filters.** Add filter pills that read the categories from your CMS, in single-select or multi-select mode. Set the pill colors, fonts and spacing.

**Hover effects.** Scale, fade, slide or bounce, with adjustable overlay colors, icons and shadow intensity.

**Grid controls.** Change columns, gaps and shadows in the properties panel and see the result straight away.

## Use Cases

**Portfolio galleries.** Visitors filter design work by project type.

**Product galleries.** Product photos open in the lightbox for a closer look, filtered by category.

**Photography sites.** The masonry layout handles photos of different heights.

**Case study libraries.** Client work grouped into filterable categories, with a quick preview.

**Media archives.** Images and videos in one collection, both playable in the lightbox.

![CMS Masonry Lightbox Preview](/framerhub/img/components/control/cms-masonry-lightbox.jpg)

## How to Use

### Setup

**Connect Your CMS**

1. Drag the component onto your canvas
2. In the properties panel, click "Connect CMS"
3. Select your CMS collection
4. The masonry layout appears automatically

**Configure Layout**

- Set your preferred number of columns (1-12)
- Adjust gap spacing between items
- Choose shadow intensity for depth

**Enable Lightbox** (optional)

- Toggle "Enable Lightbox" in the properties panel
- Specify your CMS image field name (default: "image")
- Specify your CMS video field name (default: "video")
- Customize hover effects and overlay styles

**Add Category Filtering** (optional)

1. Paste the CMSMasonboxFilter component above your gallery
2. Set the "Category Field" to match your CMS field name
3. Choose single or multi-select mode
4. Customize pill colors, fonts, and spacing

Both components connect through a shared "Store Key", so you don't link them by hand.

### Quick Tips

**Columns.** 3 to 4 columns on desktop, 2 on tablet and 1 on mobile read best.

**Field names.** Your image and video field names must match the names set in the properties panel exactly.

**Filter setup.** If your CMS uses a different field name for categories, update it in both components.

**Large collections.** For 90+ items, consider a CMS pagination limit.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
