Use cases

What people use galleries for, each with the block behind it. Run Create use-case notes (or Create showcase notes) to get all of them as notes in GalleryDemo/Use cases/, with real photos to try them on. The photos are an optional download of about 10 MB; see Network use.

Every local example uses a path relative to the note (./_photos/…), so the gallery keeps working when the note and its folder move together.

Travel journal

A trip write-up with the photos in tidy rows of equal height, each one uncropped. Captions show on hover, so the rows stay clean.

```obs-gallery
sources:
  - type: local
    path: ./_photos/iceland
view:
  type: justified
  rowHeight: 240
  captions: false
```

Click a photo to open the full-screen viewer.

One folder, six layouts

The same folder as masonry, justified, mosaic, thumbnail, carousel (height: 480) and embed (with limit: 3 on the source). Only view: type changes.

To switch layouts, change one word:

```obs-gallery
sources:
  - type: local
    path: ./_photos/iceland
view:
  type: masonry   # or justified, mosaic, thumbnail, carousel, embed
```

Mood board

A borderless masonry board that sits straight in the note.

```obs-gallery
sources:
  - type: local
    path: ./_photos/cabin
view:
  type: masonry
  columnWidth: 220
  gap: 8
  frame: false
```

Recipe

Full-width photos under the method, with captions. Sorting by name keeps step photos in order when they are numbered (1 – …, 2 – …).

```obs-gallery
sources:
  - type: local
    path: ./_photos/recipe
    sort:
      by: name
      order: asc
view:
  type: embed
  captions: true
```

Reference library

A paged grid for a folder that keeps growing. Only the current page loads.

```obs-gallery
sources:
  - type: local
    path: ./_photos/design
view:
  type: thumbnail
  pagination: true
  itemsPerPage: 6
```

Highlights carousel

The first eight photos of a folder, one at a time on a fixed-height stage.

```obs-gallery
sources:
  - type: local
    path: ./_photos/iceland
    limit: 8
view:
  type: carousel
  height: 520
```

Family album from Immich

Photos straight from an Immich server, without copying them into the vault: here, the trip's photos picked out by tag and date. This one uses the demo server.

On a phone, justified rows rewrap to the screen width:

```obs-gallery
sources:
  - type: immich
    connection: immich-demo
    filters:
      tags:
        - Iceland
      takenAfter: "2026-08-24"
view:
  type: justified
```

Network use

The use-case notes' photos are downloaded from docs.mkshp.dev, the host of these docs, only if you leave Download sample photos on in the dialog that Create showcase notes and Create use-case notes show first. They are saved in GalleryDemo/Use cases/_photos/ and load from your vault after that. If the download fails, the notes are still created, and Start here explains how to try again.

Photo credits

All 39 sample photos are from Unsplash, free to use under the Unsplash License. Thanks to the photographers below. The same list is in CREDITS.md next to the photos.

Iceland (20)

Photo	Photographer	Source	License
Aurora over Kirkjufell.jpg	Landon Arnold	Unsplash	Unsplash License
Behind Seljalandsfoss.jpg	jossemio	Unsplash	Unsplash License
Black sand at Reynisfjara.jpg	With Paul	Unsplash	Unsplash License
Canyon of Fjaðrárgljúfur.jpg	Thomas Fatin	Unsplash	Unsplash License
Church above Vík.jpg	Jon Flobrant	Unsplash	Unsplash License
Diamond Beach ice.jpg	Andy Mai	Unsplash	Unsplash License
Drifting icebergs at Jökulsárlón.jpg	Jeremy Bishop	Unsplash	Unsplash License
Face to face with an Icelandic horse.jpg	kyler trautner	Unsplash	Unsplash License
Glacier view at Jökulsárlón.jpg	Denys Nevozhai	Unsplash	Unsplash License
Hallgrímskirkja against a blue sky.jpg	Toby Elliott	Unsplash	Unsplash License
Icebergs in a glacier lagoon.jpg	Gian-Reto Tarnutzer	Unsplash	Unsplash License
Northern lights at Kirkjufell.jpg	Joshua Earle	Unsplash	Unsplash License
Puffin on a rock.jpg	Ray Hennessy	Unsplash	Unsplash License
Road through the lava fields.jpg	Tom Podmore	Unsplash	Unsplash License
Skógafoss from above.jpg	Adrian Fiodor	Unsplash	Unsplash License
Skógafoss up close.jpg	Karsten Winegeart	Unsplash	Unsplash License
Svartifoss and its basalt columns.jpg	Bailey Galindo	Unsplash	Unsplash License
Svínafellsjökull glacier panorama.jpg	Joseph Corl	Unsplash	Unsplash License
The Blue Lagoon.jpg	F D	Unsplash	Unsplash License
Vestrahorn above the Stokksnes dunes.jpg	Wanderlust in Frame	Unsplash	Unsplash License

Cabin (10)

Photo	Photographer	Source	License
Bedroom window over rolling hills.jpg	Caroline Badran	Unsplash	Unsplash License
Cabin kitchen in dark wood.jpg	Hans	Unsplash	Unsplash License
Ceramic lamp with dried branches.jpg	Caroline Badran	Unsplash	Unsplash License
Hanging fireplace and string lights.jpg	Hans	Unsplash	Unsplash License
Living room facing the green hills.jpg	Caroline Badran	Unsplash	Unsplash License
Pendant lamps over the dining nook.jpg	Caroline Badran	Unsplash	Unsplash License
Pillows under a slanted window.jpg	Caroline Badran	Unsplash	Unsplash License
Plaid blanket on the cabin bed.jpg	Hans	Unsplash	Unsplash License
Sofa and knitted throw under a wooden ceiling.jpg	Caroline Badran	Unsplash	Unsplash License
Wooden loft with a trailing plant.jpg	Caroline Badran	Unsplash	Unsplash License

Recipe (1)

Photo	Photographer	Source	License
Shakshuka served for brunch.jpg	Sara Dubler	Unsplash	Unsplash License

Design (8)

Photo	Photographer	Source	License
Barbican Estate courtyard.jpg	Daniel Moore	Unsplash	Unsplash License
Chalkboard quote on a yellow wall.jpg	Far Chinberdiev	Unsplash	Unsplash License
Corner of Boston City Hall.jpg	Mark McLaughlin	Unsplash	Unsplash License
Curved white walls by a pool.jpg	Leo Manjarrez	Unsplash	Unsplash License
National Theatre against a pale sky.jpg	Simone Hutsch	Unsplash	Unsplash License
Painted wooden prayer plaque.jpg	CR	Unsplash	Unsplash License
White stairs in a plaster stairwell.jpg	Alesia Kazantceva	Unsplash	Unsplash License
WHO ARE YOU in painted letters.jpg	New York Said	Unsplash	Unsplash License