Recurring Events
Recurring events let you create a single event that repeats on a schedule. Eventonomy generates a materialized occurrence for each date - so each instance appears on the calendar with its own RSVP counts, and attendees can RSVP to a specific date.
What You Will Learn
- How to set up a recurring event
- Which repeat patterns are supported
- How occurrences are generated and updated
- How RSVPs work across a series
- How to cancel or update a single occurrence
Enabling Recurrence
Note: Recurring events must be enabled at Eventonomy → Settings → Display → Recurring events. The feature is on by default.
When creating or editing an event, open the Recurrence panel in the event editor and toggle Repeats on.
Repeat Patterns
| Frequency | Examples |
|---|---|
| Daily | Every day, every 2 days |
| Weekly | Every Monday, every other Tuesday and Thursday |
| Monthly | The 15th of each month, last Friday of each month |
| Yearly | Once a year on the same date |
For each frequency you can set:
- Interval - repeat every N days/weeks/months/years.
- Days of week (weekly only) - choose specific days, e.g. Monday and Wednesday.
- Ends - never, after N occurrences, or on a specific date.
How Occurrences Are Generated
When you save a recurring event, the OccurrenceMaterializer service expands the recurrence rule into individual rows in the evnm_occurrences table. It expands up to the Recurrence horizon setting (default: 12 months ahead, configurable at Settings → Display → Recurring events → Expand recurring events up to).
A daily cron job (evnm_cron_recompute_occurrences) extends the horizon as time passes, so future occurrences are always ready.
Note: The maximum number of occurrences that can be generated for one event scales with the horizon window. For a 2-year daily event with a 24-month horizon, Eventonomy generates all 730 occurrences. The limit is filterable via
evnm_recurrence_max_occurrencesfor edge cases.
RSVPs on Recurring Events
By default, attendees RSVP to the event as a whole. You can also scope RSVPs to individual occurrences so each date has its own capacity and attendee list.
- Event-scoped RSVP - one RSVP covers all dates. Capacity and counts apply at the event level.
- Occurrence-scoped RSVP - each date has its own capacity. Attendees pick a specific date when RSVPing.
Updating a Recurring Event
When you edit a recurring event after occurrences have been generated, you choose the scope of the change:
| Scope | What updates |
|---|---|
| This occurrence | Only the selected date instance |
| This and future occurrences | The selected date and all dates after it |
| All occurrences | Every instance in the series, past and future |
Cancelling a Single Occurrence
To cancel one date without cancelling the whole series:
- Open the event.
- Navigate to the specific occurrence (click the date on the calendar or use the Occurrences list in the admin).
- Set the occurrence status to Cancelled.
The rest of the series continues unaffected. Attendees scoped to that occurrence receive a cancellation notification.
What's Next?
Learn how to create and manage the shared Venue and Organizer catalog.