<aside> 💡 This explanation and code was written by Martin Boehme. Last updated March 17, 2022

</aside>

This is a reference and code overview for our recurring tasks function.

<aside> 💡 For a straightforward guide on upgrading a copy of Ultimate Tasks duplicated prior to March 16, 2022, check out the upgrade guide: 3/16/22 - Better Recurring Tasks & More

</aside>

Template designers: These formulas are free to use, but we ask that you include attribution with a link to Thomas’ templates page if used in a public Notion template (free or paid).

Overview

Recurring Tasks now requires several different visible properties and helper properties to function. Theoretically, one could put it all in one box, but it would greatly, greatly increase the amount of code being interpreted and likely ruin Notion’s performance, given some testing we did with earlier versions of this upgraded system.

Many thanks to Red Gregory, who was a great source for learning how to port some of my regular programming knowledge over to Notion!

Visible Properties:

• Due Date | (date)
• Recur Interval | (number)
• Recur Unit | (select)
  • Day(s)
  • Week(s)
  • Month(s)
  • Month(s) on the First Weekday
  • Month(s) on the Last Weekday
  • Month(s) on the Last Day
  • Year(s)
• Days (Only if Set to 1 Day(s)) | (multi-select)
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday
  • Sunday

Helper Properties:

• Simplified Recur Unit
• Last Day Base Date
• Next Last Base Date
• First Weekday Base Date
• Last Weekday Base Date

The helper properties here are all needed because they are complex formulas that need to be used several times in varying places. The reason they can’t all be rolled into one formula is that if we wanted to check any complex formula’s resulting value and then manipulate it, we would need to re-run the same formula over and over.