Defining recurrence rule

Owned by Mateusz Daleki
Last updated: May 22, 2022
3 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...

Rules can be defined with user friendly forms as below:

Daily repeats frequency

Wheekly repeats frequency

Monthly repeats frequency

Yearly repeats frequency

1st working day of the month repeats frequency

Last working day of the month repeats frequency

Configuration fields for recurrence

FIeld name

Description

FIeld name

Description

Repeats

Define frequency of recurrence.

Possible values:

  • Daily - action will repeat every day

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

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

  • Yearly- 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 Manage 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 Manage non-working days

Repeats every

The interval between each frequency iteration.

For example, when using 'Repeats' equal to `Daily`, an 'Repeats every' equal to 3 means once every three days, but with 'Repeats' equal to `Monthly`, it means once every three months.

Repeat on

Define the weekdays where the weekly recurrence will be applied. This field is only available for 'Repeats' equal to `Weekly`.

For example, when using 'Repeats' equal to `Weekly` and 'Repeats every' 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 'Repeats' equal to `Monthly`. 

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 Manage non-working days