Reference/tiles.md
tiles: getting around
Properties
code block
tileskeys
2 on the block, 12 on each tile
checked on
Dashy 2.2.0
A grid of link tiles for navigating the vault.
Prefer to have your agent write it? Build a dashboard with an AI agent.
From the demo vault
```tiles
columns: 4
items:
- { label: Inbox, path: Inbox, icon: 📥, badge: count }
- { label: Diary, path: Diary, icon: 📔, badge: count, sub: one note a day }
- { label: Books, path: Books, icon: 📚, badge: count }
- { label: Sport, path: Diary, icon: 🏃, accent: true, sub: training log }
```
renders as
A minimal block
The shortest config worth pasting. Change the folder and the property names to yours.
```tiles
columns: 4
items:
- { label: Inbox, path: 00-Inbox, icon: 📥, badge: count }
- { label: Sport, path: 01-Areas/Sport/Training-Log, icon: 🏆, sub: workouts, accent: true }
```
Keys on the block
| Key | What it does | Type | Default |
|---|---|---|---|
columns |
columns in the grid, 1 to 8. On a phone a block never shows more than two columns | number | 4 |
items required |
the list of tiles | list | none |
Keys on each tile
Each entry under items is one tile.
| Key | What it does | Type | Default |
|---|---|---|---|
label requiredalso title, name |
caption | text | none |
path required |
where it leads: a note, File.base#View, or a folder. A folder opens its folder note, Folder/Folder.md or else Folder.md next to it, and without one shows the folder in the file explorer. A name YAML reads as a number goes in quotes, path: "2024": a number, a list, a map or a boolean is an error, and the tile has no link and no count badge |
text | none |
tag |
tag, with or without the hash; narrows badge: count |
text | none |
where |
a condition like year = 2026, rating >= 4, tags contains books, or several that must all hold: joined with and (year = 2026 and rating >= 4) or written as a list ([year = 2026, "rating >= 4"]). The field name may be a dotted path into a nested property, like health.sleep > 70. date empty keeps the notes where a property is missing, blank or an empty list, and date not empty the notes where it holds a value, 0 and an unticked checkbox included. or is not supported; quote a value holding the word and or or. One unreadable condition drops the whole filter with a warning, and the count is drawn unfiltered. Narrows badge: count |
text or list | none |
period |
narrow badge: count to a window: week, month, year (the current calendar one) or a rolling count of days like 30d, all ending today; note, the day, week, month, quarter or year the name of the note this block sits in stands for, like 2026-W40; a period written out the same way: 2026-10-01, 2026-W40, 2026-10, 2026-Q4 or 2026; or { from: 2026-09-01, to: 2026-09-30 }, both days included, from alone running to today. Notes without a date are left out first. A week starts on the first day of the interface language, Dashy's own when one is picked in its settings, otherwise Obsidian's: Sunday in English, Monday in most European languages; a week named like 2026-W40 is the seven days its name stands for |
text or number or map | none |
date_field |
a date frontmatter property to read instead of the note name for period: 2026-03-02 or 2026-03-02T10:30, or in date_format or the Daily notes day format, or a dotted path into a nested property like meta.date; has no effect without period |
text | none |
date_format |
a date format for note names and date_field values not written as YYYY-MM-DD, in moment notation: DD.MM.YYYY, MM/DD/YYYY, YYYYMMDD. Tried after YYYY-MM-DD and before the day format of the Daily notes or Periodic Notes settings, which is read without this key. A name or a value only has to start with the date (05.10.2026 Monday counts); the match is strict, so 5.10.2026 is no date under DD.MM.YYYY. Needs a year, a month and a day, and warns when no selected note fits it; has no effect without period |
text | none |
iconalso emoji |
emoji | text | none |
sub |
small caption under the title | text | none |
badge |
count, meaning the number of notes in the folder narrowed by tag, where and period when given, or your own string |
text or number | none |
accent |
accent stripe on the left | true or false | none |
image |
a cover image above the icon and label: a vault path (Attachments/gym.jpg), a [[wikilink]], or an https:// URL. A vault path that does not resolve, or anything other than those three, warns and the tile draws without a cover |
text | none |
How it behaves
period: noteon abadge: counttile counts the notes dated in the day, week, month, quarter or year the name of the note the block sits in stands for: in a note named2026-W40,{ label: Workouts, path: Training, badge: count, period: note }counts that week's workouts.period: 2026-10orperiod: { from: 2026-09-01, to: 2026-09-30 }names the window outright. A note not named for a period is an error, except in a template, a note in the template folder of the core Templates plugin or of Templater, where the block draws no tiles but a line saying the note is a template, under any other problem the config has; a window that has not started yet shows no badge and says the day it starts.- A
badge: counttile withperioddates its notes by name,YYYY-MM-DDfirst, then the day format set in the Daily notes or Periodic Notes settings. Daily notes named another way with no such setting need the tile's own format:{ label: Diary, path: Diary, badge: count, period: week, date_format: DD.MM.YYYY }counts05.10.2026.mdand its neighbours of this week.
Guides that use it
Dashy is in Obsidian's community plugins. Search for Dashy, install, enable, then run Dashy: Insert block and pick tiles.