# Tasks Plugin
Tasks Plugin (opens new window) track tasks across your entire vault and helps users to manage tasks.
# Tasks Plugin's Task Format
If you enable setting, following format recognized as reminder.
- [ ] Task 📅 2021-09-16
In this case, reminder will be notified on 2021-09-16.
Reminder time is based on the default reminder time.
When you toggle checklist status, done date will be inserted like following.
- [x] Task 📅 2021-09-16 ✅ 2021-09-17
The due date can also carry a time, as an extension beyond what the Tasks Plugin itself supports. In this case, the reminder fires at that time instead of the default reminder time.
- [ ] Task 📅 2021-09-16 10:00
Note
- You can't customize the due date format (
YYYY-MM-DD, optionally followed byHH:mm) for interoperability with Tasks Plugin - If you want to specify the reminder time separately from the due date in the Tasks Plugin, you can use reminder emoji.
# Recurring tasks
Tasks plugin supports recurring tasks.
- [ ] Task 🔁 every Sunday 📅 2021-09-16
Reminder plugin also supports this feature.
When you toggle checklist status, next recurring task will be created.
# Distinguish due date and reminder date
If you want to specify the reminder time separately from the due date in the Tasks Plugin, enable this setting.
When you enable this option, the following task's reminder date will be 2021-09-16 (Not 2021-09-17).
- [ ] Task ⏰ 2021-09-16 📅 2021-09-17
Also you can specify time:
- [ ] Task ⏰ 2021-09-16 10:00 📅 2021-09-17
TIP
You can change date/time format. See Date Time Format.
WARNING
You can't insert any characters other than date/time between ⏰ and 📅.
- (OK)
- [ ] Task ⏰ 2021-09-16 📅 2021-09-17 - (NG)
- [ ] Task ⏰ 2021-09-16 #Tag 📅 2021-09-17
# Fall back to due, scheduled, or start date
With "Distinguish between reminder date and due date" enabled, a task without ⏰ is normally not treated as a reminder at all. If you enable Fall back to due, scheduled, or start date, the reminder date falls back through 📅 (due), then ⏳ (scheduled), then 🛫 (start), in that order, whenever ⏰ is missing.
- [ ] Task ⏳ 2021-09-16
Here, the reminder fires on 2021-09-16 even though no ⏰ is present.
TIP
When both 📅 and ⏳ are present, 📅 always wins — the fallback order mirrors the Tasks Plugin's own specificity (due date is more specific than scheduled date). To make a task remind on its scheduled date instead of its due date, set an explicit ⏰ equal to the scheduled date.
Snoozing ("remind me later") always writes ⏰ and never overwrites 📅/⏳/🛫, so the due/scheduled/start date on the line is preserved even after you snooze a fallback-triggered reminder.
# Using the Tasks plugin's Dataview task format
The Tasks plugin also supports writing task metadata as Dataview inline
fields ([due:: 2021-09-16]) instead of emoji. This plugin reads that
syntax through a separate format — see the Dataview
format guide.