Reference/today.md
today: where the day starts
Properties
code block
todaykeys
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
daily: true
weekly: true
monthly: true
```
renders as
A minimal block
The shortest config worth pasting. Change the folder and the property names to yours.
```today
clock: true
daily: true
weekly: true
monthly: true
```
Keys
| Key | What it does | Type | Default |
|---|---|---|---|
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 |
nav |
with date: note, links to the day before and the day after, named and filed like the daily note; false hides them. Without date: note it warns and is ignored |
true or false | true |
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,weeklyandmonthlygiven, 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: notewithweekly: trueandmonthly: truegives 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 wayperiod: notereads it: the day format set in Periodic Notes or Daily notes, thenYYYY-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 is2026-W53inGGGG-[W]WWand2027-W01ingggg-[W]wwunder 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:clockwithdate: notewarns and is not shown.
Guides that use it
Dashy is in Obsidian's community plugins. Search for Dashy, install, enable, then run Dashy: Insert block and pick today.