countdown
Dashy vault/Reference/countdown
Reference/countdown.md

countdown: what is coming

Properties
code block
countdown
keys
2 on the block, 4 on each date
checked on
Dashy 1.5.2

Cards counting the days to a date.

From the demo vault

countdown
```countdown
columns: 3
items:
  - { label: IRONMAN 70.3, date: 2027-06-14, icon: 🏊 }
  - { label: Holiday, date: 2027-01-20, icon: 🏖, sub: two weeks off }
  - { label: Review, date: 2027-03-01, icon: 🗒 }
```
renders as
Three cards counting the days to a race, a holiday and a review

A minimal block

The shortest config worth pasting. Change the folder and the property names to yours.

countdown
```countdown
columns: 3
items:
  - { label: IRONMAN 70.3, date: 2026-11-15, icon: 🏊 }
  - { label: Holiday, date: 2026-12-20, icon: 🏖, sub: two weeks off }
```

Keys on the block

columnsitems
KeyWhat it doesTypeDefault
columns columns in the grid, 1 to 6 number 3
items required the list of dates list none

Keys on each date

Each entry under items is one date.

labeldateiconsub
KeyWhat it doesTypeDefault
label requiredalso title, name what the date is text none
date required the date itself, YYYY-MM-DD text none
iconalso emoji emoji text none
sub small caption under the label text none

How it behaves

  • A date that has passed is shown too, counting up instead of down. What happened yesterday is still worth seeing.
  • The day count is whole days, so a daylight saving switch cannot shift it.
  • The date does not repeat every year: a birthday or anniversary needs its year moved forward by hand once it has passed.