today
Dashy vault/Reference/today
Reference/today.md

today: where the day starts

Properties
code block
today
keys
7
checked on
Dashy 2.2.0

A day row: today's date, or the day a daily note is named for, an optional live clock, and links to the daily, weekly and monthly notes.

Prefer to have your agent write it? Build a dashboard with an AI agent.

From the demo vault

today
```today
daily: true
weekly: true
monthly: true
```
renders as
The date and three chips linking to the daily, weekly and monthly notes

A minimal block

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

today
```today
clock: true
daily: true
weekly: true
monthly: true
```

Keys

KeyWhat it doesTypeDefault
daily link to the daily note true or false true
weekly link to the weekly note true or false false
monthly link to the monthly note true or false false
title a custom heading instead of today's date text none
clock a live clock above the date: true or minutes for hours and minutes, seconds to add the seconds. A 12 or 24 hour clock follows the language, the same as the date. Any other value warns and shows no clock. With date: note the clock warns and is not shown true or false or text false
date note: the day of the note this block sits in, read from its name, instead of today. The heading shows that day and the chips link its daily, weekly and monthly notes. Only a day's name will do: in a weekly note it is an error. Any other value warns and shows today text none

How it behaves

  • Takes the folder and the name format from the Periodic Notes plugin when installed, 1.0 beta included. The day comes from Periodic Notes only when it is switched on there, otherwise from the core "Daily notes", as the Calendar plugin does. A folder set in the Dashy settings wins over both.
  • With none of daily, weekly and monthly given, only the daily note is shown. With at least one given, exactly those apply.
  • The clock only changes its own digits, on the minute (or the second), and does not reread the vault. The date under it changes when the day does, at the hour set by "New day starts at" in the Dashy settings: with the day starting at 4:00, a clock that reads 01:30 still sits above yesterday's date.
  • If the note does not exist yet the link is still drawn, dimmed: clicking it creates the note.
  • In a daily note template, date: note with weekly: true and monthly: true gives every daily note a line with its own week and month, and the day before and after, however late the note is opened. The day is read from the note's name the way period: note reads it: the day format set in Periodic Notes or Daily notes, then YYYY-MM-DD, and a name may go on after the day past a space, _ or - (2026-11-09 Monday). A note named for a week, a month or anything but a day is an error that lists those formats. In the template folder of the core Templates plugin or of Templater, a name that is no period is no error: the block shows a line saying the note is a template. The week and month links name the day's week and month the same way today's do, so the week of 1 January 2027 is 2026-W53 in GGGG-[W]WW and 2027-W01 in gggg-[W]ww under English. The chips read Day, Week and Month, not Today and This week, and the daily chip of the note itself is drawn without a link. No clock: clock with date: note warns and is not shown.