# Gallery Options that control how the gallery page is rendered. Configured under `ipp.gallery`. ## Example Show the gallery title and group photos by month: ```json { "ipp": { "gallery": { "showTitle": true, "groupByDate": "month" } } } ``` ## `singleImage` **Type:** `bool` · **Default:** `false` By default a link to a single image will directly open the image file. Set to `true` if you want to show a gallery page instead for a single item. ## `singleVideo` **Type:** `bool` · **Default:** `true` When a share contains a single video, show a gallery page. Set to `false` to link directly to the video file instead. ## `singleItemAutoOpen` **Type:** `bool` · **Default:** `true` When a share contains a single item and is opened on its gallery page, automatically open the lightbox on the asset. ## `showTitle` **Type:** `bool` · **Default:** `true` Show a title on the gallery page. This is taken from the album title if it is an album being shared, otherwise the "Description" from the shared link will be used. ## `showDescription` **Type:** `bool` · **Default:** `false` Show the album description below the title. This only applies if it is an album which is being shared. ## `showExpiryDate` **Type:** `bool` · **Default:** `false` Show the share's expiry date next to the item count in the subtitle, as `45 items · available until 2026-07-10`. Only appears when the share actually has an expiry set in Immich (shares set to "never" show nothing extra). ## `expiryDateFormat` **Type:** `string` · **Default:** `"YYYY-MM-DD"` Format for the [`showExpiryDate`](#showexpirydate) date, as a [dayjs format string](https://day.js.org/docs/en/display/format). The default is ISO 8601 (e.g. `2026-07-10`). Example: `"D MMMM YYYY"` renders `10 July 2026`. Name-based tokens (`MMMM`, `dddd`, ...) render in English unless you also set [`expiryDateLocale`](#expirydatelocale). ## `expiryDateLocale` **Type:** `string` · **Default:** `""` Locale for [`showExpiryDate`](#showexpirydate) when the format uses name tokens (e.g. `MMMM` for month names), as a [dayjs locale code](https://github.com/iamkun/dayjs/tree/dev/src/locale) such as `"de"`, `"fr"` or `"en-gb"`. The default (`""`) is dayjs's default English. The numeric default format needs no locale. Applies only to this server-rendered date; thumbnail date-group headers ([`groupByDate`](#groupbydate)) already follow each viewer's own browser locale. ## `groupByDate` **Type:** `bool` or `string` · **Default:** `false` Group the gallery's thumbnails by date, with a header above each group. - `false` - no grouping (default). - `"month"` - month headers like "December 2024". - `"day"` - day headers like "Wed, 25 Dec 2024" (matching Immich's own timeline format). Grouping uses each photo's local "taken" date (matching Immich's own timeline). Photos follow the album's own sort order from Immich - "Oldest first" puts the earliest group at the top, "Newest first" the most recent - and default to newest-first for shares with no album order. Items missing a creation date end up under an "Undated" bucket at the end (or render without any header when the whole gallery is undated). > [!IMPORTANT] > Requires **"Show metadata"** to be enabled on the share in Immich. When that's off, Immich strips creation dates from the assets it returns to IPP, so grouping won't work. ## `showDownloadZip` **Type:** `bool` · **Default:** `true` Show the bulk-zip download UI - the "download all" button in the header and the multi-select download toolbar. Only takes effect when downloads are also allowed by [`allowDownload`](/config/ipp-options#allowdownload). Set to `false` to hide the zip download while still offering per-asset downloads via the lightbox ([`lightbox.showDownload`](/config/lightbox#showdownload)). ## `cacheTime` **Type:** `int` How long (in seconds) browsers and any CDN may cache the gallery **page** before revalidating. Set this longer to reduce load on your server, but be aware that if you add new photos to a gallery they won't show up until the cache times out or you manually clear any downstream caches.