Dated list

Records grouped by month in the page language's calendar, with a range, a table of contents, and feed and calendar links.

Trust: Unreviewed
Examples
Not recorded
Drift
Not recorded
Last reviewer
No reviewer recorded

Why this level

  • No review is recorded for this page, so its evidence has not been checked by a reviewer.

2 minutes read

On this page

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

  1. An older entry

January 2026

  1. A second entry

February 2026

  1. A first entry

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.

View Markdown

Use with an agent
View Markdown

Open in