> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gallery

> A masonry gallery of photographs with captions, category filters and a full-screen viewer, each photograph optionally linked to a product or story.

![Gallery on the storefront](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/gallery.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=f523a14a53efb1301094b9cd72af0848)

Gallery, highlighted with the demo content

## Where to find it

The Gallery template. In the theme editor choose Pages, then gallery, and select Gallery.

## How it works

* Photographs fill two, three or four columns on large screens.
* Category buttons appear when photographs have two or more categories. They filter the photographs in place.
* A click opens the photograph larger. Shoppers move through them with arrows, the arrow keys, Home and End, or a swipe.
* A photograph with a product gets a Shop this piece link under its caption; without a product, the Other link is used.

![Gallery in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-gallery.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=d6ea9bbb3c5095fbcef0bd530193f228)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Add a Photograph block per image (up to 40) with a Caption and a Category such as Collections, Atelier or The salon.
* Choose a Product, or an Other link and its label.
* Choose Columns on large screens and turn Show category filters on or off.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |
| **Heading** | Text. Optional. On a gallery page the page hero holds the main heading. |
| **Columns on large screens** | Options: Two, Three, Four. Default: Three. |
| **Show category filters** | On or off. Appears when photographs have two or more categories. Default: on. |

> [!TIP]
>
> Shoppers open each photograph larger and move through them with arrows, the arrow keys or a swipe.

## Blocks

Up to 40 blocks. Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### Photograph

| Setting | What it does |
| - | - |
| **Photograph** | Image: upload one or choose from Content → Files. |
| **Caption** | Text. Default: A piece under a single light. |
| **Category** | Text. For example Collections, Atelier or The salon. Photographs with the same category are filtered together. |
| **Product** | Choose a product. Adds a Shop this piece link under the caption. |
| **Other link** | Link: a page, product, collection or web address. Used when no product is chosen, for example a journal story. |
| **Other link label** | Text. Default: Read the story. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.