Repeating tasks
A repeating task is one task that comes back: the bins every second Wednesday, the cat’s medicine every other day, the plants a few days after you last watered them. Each time it comes round is an occurrence. When you finish one, it’s logged, and the task moves on to its next date.
Setting a repeat
Section titled “Setting a repeat”The quickest way is shorthand in quick add, like ~weekly, ~2d or ~mon,thu. See Quick-add shorthand.
For everything else, open the task and select the pill beside Repeat (it says Doesn’t repeat until you’ve set one). The Repeat dialog has three choices:
- How often: Doesn’t repeat, Daily, Weekdays, Weekly, Fortnightly, Monthly, Yearly or Custom…. Custom gives you Every so many days, weeks, months or years (up to 99), and for weeks, On particular days.
- Count the next one from:
- The calendar: it stays on its day, even when you’re late. Bins on Wednesday are still on Wednesday. This is the default.
- When I finish: the next one is counted from the day you tick it off. Water the plants a day late, and the next watering moves too. This is only for a plain “every so often” rule; a rule on particular days always keeps to its days.
- Ends: Never, On a date, or After so many times.
A line at the bottom previews the next few dates, so you can check the rule before you select Save. Stop repeating turns it back into an ordinary task, keeping its history.
A few rules of thumb:
- Weekly repeats seven days after the due date. For a rule on named days, choose Custom… and tick them.
- Monthly on the 31st falls on the last day of shorter months (30 April, 28 February) and goes back to the 31st when it can.
- A repeat set on a task with no date starts today.
Once a task repeats, its row shows the rule (Weekly, Every other day), and the task shows 🔥 4 in a row, plus how many are left if the series ends after a number of times.
What each action does
Section titled “What each action does”Every way out of an occurrence says what it does to the schedule, meaning the dates of the ones after it. This is the whole idea: finishing late never drags the schedule with it.
| You | This occurrence | The ones after it | Its streak |
|---|---|---|---|
| Tick it on time | Done | Unchanged | +1 |
| Tick it late | Done late | Unchanged: Monday’s dose ticked on Tuesday still leaves the next one on Wednesday | +1 |
| Missed it | Missed, and it leaves Overdue | Unchanged | Back to 0 |
| Reschedule… › Move the schedule | Moves to the new date | Counted from the new date | Unchanged |
| Reschedule… › Just this one | Moves to the new date | Stay where they were | Unchanged |
| Pause… | Paused, hidden from the Board, no reminders | Unchanged | Frozen, not broken |
| Nothing at all | Not marked, once the next one comes round | Unchanged | Back to 0, until you correct it |
| Some of its ticks, not all | Partly done, once the next one comes round or you choose Missed it | Unchanged | +1 |
A rule counted When I finish is the exception: its next one is always counted from the day you tick it.
Finishing an occurrence
Section titled “Finishing an occurrence”Tick it as you would any task. The occurrence goes into Done today, and the task comes back in its next group with a toast like Done. Next due on Friday. Its checklist is unticked, ready for next time. Every fifth in a row gets a celebration of its own, with a toast like 10 in a row. Well done.
To undo it, untick the occurrence in Done today, or select Undo on the toast. Only the latest occurrence can be unticked: once the next one has been done, the earlier one is history.
Missed it
Section titled “Missed it”Missed it is for “the bins didn’t go out, I was away”. It clears the task out of Overdue without pretending it was done, and the schedule carries on: the task moves to its next date that isn’t already past. The toast says when that is, like Marked as missed. Next due on Wed 7 Oct.
It’s offered, in the row menu and on the task, only while an occurrence is due today or overdue.
Rescheduling
Section titled “Rescheduling”Reschedule… is in every task’s row menu, repeating or not. Pick Today, Tomorrow, In 2 days, In a week, or any date from the picker. For a repeating task, choose what happens under And the ones after it?:
- Move the schedule: the rule counts from the new date from now on. A weekly rule on one named day takes the new day, so every second Wednesday moved to a Thursday becomes every second Thursday.
- Just this one: only this occurrence moves. The next one is where it would have been anyway.
The choice starts on Move the schedule for a rule counted in days, or When I finish, where the rhythm is the point (the cat’s medicine), and on Just this one for everything else, where the day is the point (bin night). The preview shows this one and the next three before you commit. An ordinary task gets the same dialog without the choice.
Pausing
Section titled “Pausing”Pausing is for holidays. Nothing comes due, no reminders go out, and streaks are frozen, not broken.
- One task: Pause… in its row menu or on the task.
- Several at once: Pause repeating tasks… (holiday) in the command palette. Every repeating task is ticked to start with.
Choose Until a date (1 week, 2 weeks, 3 weeks, or a date of your own) or Until I resume, and select Pause. The preview says when each one comes back.
While paused, a task sits in the Paused group on the List, isn’t on the Board, and the List’s paused chip says how many and until when.
A pause with a date ends by itself on that day. To end one early, select Resume in the row menu or on the task. Either way, the task comes back on its first scheduled date on or after the day it resumes (a When I finish rule comes back on that day itself), and each occurrence it skipped is logged Paused, which doesn’t count against its streak.
Not marked, and correcting it
Section titled “Not marked, and correcting it”If an occurrence is still open when the next one comes round, it’s logged Not marked and the task moves on. It waits until your new day has started, so a late night doesn’t count against you. This happens every quarter-hour, and whenever you open the List or the Board.
The task’s Recent row shows its last twelve occurrences as dots, oldest first: done, done late, partly done (a half disc), missed, not marked or paused, each a different shape. A hollow dot is one that wasn’t ticked in time. If you did it after all, select it. It becomes Done late, and the streak comes back by itself.
A rule counted When I finish is never marked this way: it simply waits for you.
Tasks that take several ticks
Section titled “Tasks that take several ticks”A repeating task can take several ticks each time it’s due, like brushing your teeth twice a day: set Times on the task, or add *2 in quick add. See Tasks that take several ticks.
The ticks are for one occurrence. The last one finishes it, and the next occurrence starts again from none, in To Do.
An occurrence that ends with some of its ticks but not all is logged Partly done: when the next one comes round, or when you choose Missed it on it. Partly done keeps the task’s streak going, and your day streak too. On the Stats page it counts half towards the habit’s completion rate. Undo on Missed it puts the ticks back.
How a series ends
Section titled “How a series ends”A repeat that ends On a date or After so many times finishes the task when its last occurrence is done, missed or goes by. Missing the last one says Missed. That was the last one. Unticking the last one picks the series back up.
Paused occurrences don’t count towards After so many times. Setting a count on a series that’s already been running counts from the occurrence due now, so “after 3 times” means three more.
