Repeating events are the core of modern organization. You can make your events repeat.
How It Works
To make this work add a suffix to one of your date properties gantt-start or gantt-end.
- If an event is a timestamp, the start date suffix will be parsed.
- If an event is a timespan instead, the end date suffix beats the start date suffix in priority if two suffices are defined.
The suffix consists of 2 comma-separated parts: How often to repeat & when to end repetitions.
1. How often to repeat
To repeat a fixed date in different years, add ' repeat yearly' or ' repeat after X years' to your date.
To repeat on day based pattern, add ' repeat daily' or ' repeat after X days' to your date.
X must be a positive integer > 0 in both cases.
Year Based Repetition
Use this for birthdays or similar events.
- Pro: Takes leap years into account.
- Con: Only works when the event’s calendar configuration is rule-based and its rule contains
year.
Calendar:
type: "rule-based"
format: ["year", "month", "day"] # must contain "year"Daily Based Repetition
To repeat any timestamp event after X days, add ' repeat after X days' to your start date. For this to work, X must be a natural number > 0.
To repeat any timespan event after X days, add ' repeat after X days' to your end date. In this case X may be zero, but never < 0.
- Pro: Works with any calendar.
- Con: Does not work for birthdays in leap year calendars.
Examples
gantt-start: 2026-09-29 repeat after 14 days # a bi-weekly taskgantt-start: 2026-09-26 repeat after 7 days # a Saturday
gantt-end: 2026-09-27 # a Sunday (this would be weekends)gantt-start: 2026-11-22 repeat yearly # a birthdaygantt-start: 2026-09-29 repeat after 4 years # Olympic games2. When To End Repetitions
By default, events start repeating themselves on the note’s start date.
Therefore, adding another start date is not possible yet
To end an event type , until [any date] after the first suffix.
As example, these are the dates of historic Olympic Games.
gantt-start: -776 repeat after 4 years, until 394