Date Range

A date range or ranges. See Date range for more information.

Settings

Key	Value
CONFIG	`date`
ENV	`KIOSK_DATE`
URL	`date`
VALUE	`[]string`
DEFAULT	`[]`

Using with config.yaml file

date:
  - 2023-01-01_to_2023-02-01
  - 2024-11-12_to_2023-11-18
  - last-30-days
  - today

Using with ENV in your docker-compose file

environment:
  KIOSK_DATE: "DATE_RANGE, DATE_RANGE, DATE_RANGE"

Using with url queries

http://{URL}?date=DATE_RANGE&date=DATE_RANGE&date=DATE_RANGE

How date ranges work as asset buckets

Date ranges in Immich Kiosk create distinct pools (or “buckets”) of assets based on their timestamps. Unlike filters that modify existing collections, each date range defines its own independent set of assets. When you specify multiple date ranges, Kiosk maintains separate buckets for each range and randomly selects one bucket during image refresh to fetch an asset from.

Allowed formats

YYYY-MM-DD_to_YYYY-MM-DD e.g.2023-01-01_to_2023-02-01
last-XX-days e.g. last-30-days