tiles
Dashy vault/Reference/tiles
Reference/tiles.md

tiles: getting around

Properties
code block
tiles
keys
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
```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
Four tiles with emoji, labels and note counts

A minimal block

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

tiles
```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

KeyWhat it doesTypeDefault
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.

KeyWhat it doesTypeDefault
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: note on a badge: count tile 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 named 2026-W40, { label: Workouts, path: Training, badge: count, period: note } counts that week's workouts. period: 2026-10 or period: { 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: count tile with period dates its notes by name, YYYY-MM-DD first, 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 } counts 05.10.2026.md and its neighbours of this week.