Dated list
Records grouped by month in the page language's calendar, with a range, a table of contents, and feed and calendar links.
A dated list groups records by month, using the page language's calendar. Each group has a heading, each record gets a date, and records without a usable date are kept in a trailing section instead of disappearing. The list can also show a fixed range of months, a table of contents, and links to a feed or calendar of the same records.
Syntax
::dated-list{from=posts date=published status=state}
or give the rows directly:
::dated-list{items='[{"date":"2026-01-05","label":"First entry","url":"/posts/first/"}]'}
Options
| Option | What it does |
|---|---|
from |
The collection to read. Required unless items is given. |
items |
A JSON array of { date, label, url?, status? }, for a list that is not a collection. |
date |
The field holding a record's date; date when omitted. |
status |
The field holding a record's status; omitted means no status is shown. |
order |
asc lists the oldest group first; desc lists the newest first. |
level |
Heading level for the groups, 2 by default; a level that would skip one falls back to 2. |
group |
year adds a year heading above each year's months. |
toc |
true puts the groups in a table of contents above the list. |
start |
First day of a fixed range of months, such as 2026-01-01. |
months |
How many months the range covers, counting the month of start; ignored without start. |
feed |
Address of a feed of the same records, shown as a Subscribe link. |
calendar |
Address of an iCalendar file, shown as an Add to calendar link. |
Live example
December 2025
- An older entry
January 2026
- A second entry
February 2026
Records with no valid date are listed here.
- An entry with no date
Without JavaScript
Every group, date, record, and the trailing undated section are in the HTML. The jump link is added by the island and stays hidden until it runs; the feed and calendar links are plain links and work without it.
Accessibility
Groups are real headings in order, each date is text, and the status keeps its label. The undated section is named rather than silently dropped. The jump link is hidden until the island runs, and the date dot keeps its shape in forced colors.