Defining recurrence rule

Owned by Mateusz Daleki
Last updated: May 22, 2022
2 min read

Setup recurrence details

Repeating Issues add-on supports recurrence rules as defined in the iCalendar RFC so use can schedule actions that:

  • occurs at given date and time

  • repeats daily, monthly, weekly and yearly 

  • repeats every n times 

  • repeats on given day of week 

  • repeats by day of the month or day of the week 

  • repeats 1st or last working day of the month

  • ends never, after x times, or on given date 

Possibilities are vast...

Configuration fields for recurrence

FIeld name

Description

FIeld name

Description

Repeat every

Define frequency and interval between each frequency iteration.

Possible frequency values:

  • Day - action will repeat every day

  • Week- action will repeat every week, on days specified by 'Repeat on' field

  • Month - action will repeat every month, on day specified by 'Repeat by' field

  • Year- action will repeat every year

  • 1st working day of the month - action will repeat every month, on 1st weekday (Monday-Friday). To adherence non-working days please read how to Managing non-working days

  • Last working day of the month - action will repeat every month, on last weekday (Monday-Friday). To adherence non-working days please read how to Managing non-working days

For example, using `Day` frequency and interval equal to 3 means once every three days, but with frequency set to `Month`, it means once every three months.

Repeat on

Define the weekdays where the weekly recurrence will be applied. This field is only available for frequency equal to `Week`.

For example, using `Week` frequency and interval equal to 1,  an 'Repeats on' equal to Mo and Fr means recurrence occurs every week on Monday and Friday

Repeat by

Define the weekday (together with 'Starts on' field) where the monthly recurrence will be applied. This field is only available for frequency equal to `Month`. 

Possible values:

  • day of the month - specify the n-th day of the month (e.g. monthly on day 23)

  • day of the week - specify the n-th weekday of the month (e.g. monthly on the third Wednesday)

Starts on

Defines the start date and time relative to which subsequent occurrences are calculated on the recurrence rule

Ends

Define when the recurrence ends.

Possible values:

  • Never - the recurrence never ends.

  • After N days - the recurrence ends after N iterations

  • On given day - the recurrence works as long as the iteration day is lower or equal given day

Calendar

Define calendar with non-working days that will be used by this recurrence rule. Please read how to Managing non-working days