Obsidian Reminder Plugin

# 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 by HH:mm) for interoperability with Tasks Plugin
  • Dates after 📅, ⏳, and 🛫 are always parsed strictly, so 📅 2021-9-8 is not a due date. The Strict Date format setting doesn't loosen this, because the Tasks Plugin only accepts YYYY-MM-DD.
  • The date must come right after the emoji. In ⏳ someday 2021-09-16, the date isn't read as the scheduled date.
  • An emoji inside an inline code span (`📅`) is not treated as a date marker.
  • 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.

# Custom statuses

The Tasks Plugin lets you define your own checkbox statuses, such as [/] for in progress or [-] for cancelled. This plugin follows them: which symbols count as done, and which symbol the Done button (or the Toggle checklist status command) writes next, come from the Tasks Plugin's status settings. You can add or override statuses with the Task statuses setting.

  • The done date (✅ YYYY-MM-DD) is inserted only when the line lands on a DONE status. Landing on a CANCELLED status inserts no date.
  • A line that carries a done date (✅) or a cancelled date (❌) counts as done, whatever its symbol, so it never reminds.

# 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

Unlike 📅, the ⏰ date follows your date and time format and the Strict Date format setting.

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.

← Dataview Format →