Quick Reference - Tasks User Guide

# Quick Reference This table summarizes the filters and other options available inside a `tasks` block.  | [[Filters]] | [[Sorting\|Sort]] | [[Grouping\|Group]] | [[Layout\|Display]] | [[About Scripting\|Scripting]] | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ---------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | **[[Filters#Filters for Dates in Tasks\|Status]]** | | | | | | `done` `not done` | `sort by status` | `group by status` | | `task.isDone` | | `status.name (includes, does not include) <string>` `status.name (regex matches, regex does not match) /regex/i` | `sort by status.name` | `group by status.name` | | `task.status.name` | | `status.type (is, is not) (TODO, DONE, IN_PROGRESS, CANCELLED, NON_TASK)` | `sort by status.type` | `group by status.type` | | `task.status.type` `task.status.typeGroupText` | | | | | | `task.status.symbol` | | | | | | `task.status.nextSymbol` | | **[[Task Dependencies]]** | | | | | | `id (includes, does not include) <string>` `id (regex matches, regex does not match) /regex/i` `has id` `no id` | `sort by id` | `group by id` | `hide id` | `task.id` | | `has depends on` `no depends on` | | | `hide depends on` | `task.dependsOn` | | `is blocked` `is not blocked` | | | | `task.isBlocked(query.allTasks)` | | `is blocking` `is not blocking` | | | | `task.isBlocking(query.allTasks)` | | **[[Filters#Filters for Dates in Tasks\|Dates]]** | | | | | | `done (on, before, after, on or before, on or after) <date>` `done (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has done date` `no done date` `done date is invalid` | `sort by done` | `group by done` | `hide done date` | `task.done` | | `created (on, before, after, on or before, on or after) <date>` `created (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has created date` `no created date` `created date is invalid` | `sort by created` | `group by created` | `hide created date` | `task.created` | | `starts (on, before, after, on or before, on or after) <date>` `starts (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has start date` `no start date` `start date is invalid` | `sort by start` | `group by start` | `hide start date` | `task.start` | | `scheduled (on, before, after, on or before, on or after) <date>` `scheduled (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has scheduled date` `no scheduled date` `scheduled date is invalid` | `sort by scheduled` | `group by scheduled` | `hide scheduled date` | `task.scheduled` | | `due (on, before, after, on or before, on or after) <date>` `due (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has due date` `no due date` `due date is invalid` | `sort by due` | `group by due` | `hide due date` | `task.due` | | `cancelled (on, before, after, on or before, on or after) <date>` `cancelled (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has cancelled date` `no cancelled date` `cancelled date is invalid` | `sort by cancelled` | `group by cancelled` | `hide cancelled date` | `task.cancelled` | | `happens (on, before, after, on or before, on or after) <date>` `happens (in, before, after, in or before, in or after) ...` `... YYYY-MM-DD YYYY-MM-DD` `... (last, this, next) (week, month, quarter, year)` `... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)` `has happens date` `no happens date` | `sort by happens` | `group by happens` | | `task.happens` | | **[[Filters#Recurrence\|Recurrence]]** | | | | | | `is recurring` `is not recurring` | `sort by recurring` | `group by recurring` | | `task.isRecurring` | | `recurrence (includes, does not include) <string>` `recurrence (regex matches, regex does not match) /regex/i` | | `group by recurrence` | `hide recurrence rule` | `task.recurrenceRule` | | **[[On Completion]]** | | | | | | | | | `hide on completion` | `task.onCompletion` | | **[[Filters#Priority\|Priority]]** and **[[Urgency\|urgency]]** | | | | | | `priority is (above, below, not)? (lowest, low, none, medium, high, highest)` | `sort by priority` | `group by priority` | `hide priority` | `task.priorityName` `task.priorityNameGroupText` `task.priorityNumber` | | | `sort by urgency` | `group by urgency` | `show urgency` | `task.urgency` | | **[[Filters#Filters for File Properties\|File properties]]** | | | | | | `path (includes, does not include) <path>` `path (regex matches, regex does not match) /regex/i` `path includes {{query.file.path}}` `path includes {{query.file.pathWithoutExtension}}` | `sort by path` | `group by path` | | `task.file.path` `task.file.pathWithoutExtension` `query.file.path` `query.file.pathWithoutExtension` | | `root (includes, does not include) <root>` `root (regex matches, regex does not match) /regex/i` `root includes {{query.file.root}}` | | `group by root` | | `task.file.root` `query.file.root` | | `folder (includes, does not include) <folder>` `folder (regex matches, regex does not match) /regex/i` `folder includes {{query.file.folder}}` | | `group by folder` | | `task.file.folder` `query.file.folder` | | `filename (includes, does not include) <filename>` `filename (regex matches, regex does not match) /regex/i` `filename includes {{query.file.filename}}` `filename includes {{query.file.filenameWithoutExtension}}` | `sort by filename` | `group by filename` | | `task.file.filename` `task.file.filenameWithoutExtension` `query.file.filename` `query.file.filenameWithoutExtension` | | `heading (includes, does not include) <string>` `heading (regex matches, regex does not match) /regex/i` | `sort by heading` | `group by heading` | | `task.hasHeading` `task.heading` | | | | `group by backlink` | `hide backlink` | | | **[[Obsidian Properties]]** | | | | `task.file.hasProperty('property name')` `task.file.property('property name')` | | **[[Filters#Description\|Description]]**, **[[Filters#Tags\|Tags]]** and other odds and ends | | | | | | `description (includes, does not include) <string>` `description (regex matches, regex does not match) /regex/i` | `sort by description` | | | `task.description` `task.descriptionWithoutTags` | | `has tags` `no tags` `tag (includes, does not include) <tag>` `tags (include, do not include) <tag>` `tag (regex matches, regex does not match) /regex/i` `tags (regex matches, regex does not match) /regex/i` | `sort by tag` `sort by tag <tag_number>` | `group by tags` | `hide tags` | `task.tags` | | | | | `show tree` | | | | | | | `task.originalMarkdown` | | | `sort by random` | | | | | **[[About Scripting\|Scripting]]** | | | | | | `filter by function` | `sort by function` | `group by function` | | | | **[[Combining Filters]]** | | | | | | `(filter 1) AND (filter 2)` | | | | | | `(filter 1) OR (filter 2)` | | | | | | `NOT (filter 1)` | | | | | | `(filter 1) XOR (filter 2)` | | | | | | `(filter 1) AND NOT (filter 2)` | | | | | | `(filter 1) OR NOT (filter 2)` | | | | | | `(filter 1) AND ((filter 2) OR (filter 3))` | | | | | | **Other Filter Options** | | | | | | `exclude sub-items` | | | | | | `limit to <number> tasks` `limit <number>` | | | | | | `limit groups to <number> tasks` `limit groups <number>` | | | | | | **Other Layout Options** | | | | | | `hide edit button` | | | | | | `hide postpone button` | | | | | | `hide task count` | | | | | | `short mode` | | | | | | `full mode` | | | | | | **Other Instructions** | | | | | | `ignore global query` | | | | | | `explain` | | | | | | `# comment` | | | | |