# 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