Recurring Events

The Events Addon supports powerful recurring event functionality, allowing you to create events that repeat on a schedule.

Understanding Recurrence Patterns

Events can recur in four ways:

Daily Recurrence:

• Event repeats every X days
• Example: Every 3 days

Weekly Recurrence:

• Event repeats on specific days of the week
• Can repeat every X weeks
• Example: Every Monday and Wednesday, or every 2 weeks on Friday

Monthly Recurrence:

• Event repeats on a specific day of the month
• Or on a specific occurrence of a weekday (e.g., first Monday, last Friday)
• Can repeat every X months
• Example: 15th of every month, or first Monday of every 3 months

Yearly Recurrence:

• Event repeats on a specific date each year
• Or on a specific occurrence of a weekday in a specific month
• Example: December 25th every year, or first Saturday in May every year

Setting Up Recurring Events

Basic Recurrence Setup:

1. Open the event for editing
2. Find the Recurrence field
3. Select the recurrence type: Daily, Weekly, Monthly, or Yearly
4. Configure the recurrence options based on the type selected

Recurrence End Date:

• Set an End Date for the recurrence (when recurring events should stop)
• If not set, recurring events will generate up to 180 days in the future

Daily Recurrence:

• Set Daily Days: Number of days between occurrences (e.g., 1 for daily, 3 for every 3 days)

Weekly Recurrence:

• Set Weekly Weeks: Number of weeks between occurrences (e.g., 1 for weekly, 2 for bi-weekly)
• Select Weekly Day(s): Which day(s) of the week (Mon, Tue, Wed, Thu, Fri, Sat, Sun)
• You can select multiple days

Monthly Recurrence:

• Choose one of two options:
  • Monthly First: Repeats on a specific day of the month (e.g., 15th of every month)
  • Monthly Second: Repeats on a specific occurrence of a weekday (e.g., first Monday, last Friday)
• Set Monthly Months: Number of months between occurrences
• For Monthly First: Set the day of month
• For Monthly Second: Set the weekday and occurrence (first, second, third, fourth, last)

Yearly Recurrence:

• Choose one of two options:
  • Yearly First: Repeats on a specific date each year (e.g., December 25th)
  • Yearly Second: Repeats on a specific occurrence of a weekday in a specific month
• For Yearly First: Set the month and day
• For Yearly Second: Set the month, weekday, and occurrence

How Recurring Events Work

When you create a recurring event:

• The original event is stored with recurrence settings
• The system generates individual event instances based on the recurrence pattern
• Each instance appears in search results and listings
• Recurring instances are marked with a special ID prefix
• The system generates recurring events up to 180 days in advance (or until the end date)

Important Notes:

• Recurring events are generated dynamically when searched or listed
• The original event remains the "master" event
• Editing the master event affects all future recurring instances
• Past recurring instances are not affected by edits