---
title: Creating a recurring event
framework: eventkit
role: article
role_heading: Article
path: eventkit/creating-a-recurring-event
---

# Creating a recurring event

Set up an event or reminder that repeats.

## Overview

Overview Recurring events repeat over a specified interval of time. To make an event recurring, assign it a recurrence rule that describes when the event occurs. Recurrence rules are represented by instances of the EKRecurrenceRule class. Recurrence is applicable to both calendar events and reminders. Unlike with recurring events, only the first incomplete reminder of a recurring set is obtainable. This is true with EventKit as well as the Reminders app. When the reminder is completed, the next reminder in the recurrence set becomes available. Create a Basic Rule You can create a recurrence rule with a simple daily, weekly, monthly, or yearly pattern using the init(recurrenceWith:interval:end:) method. You provide three values to this method: The recurrence frequency. This is a value of type EKRecurrenceFrequency that indicates whether the recurrence rule is daily, weekly, monthly, or yearly. The recurrence interval. This is an integer greater than 0 that specifies how often a pattern repeats. For example, if the recurrence rule is a weekly recurrence rule and its interval is 1, then the pattern repeats every week. If the recurrence rule is a monthly recurrence rule and its interval is 3, then the pattern repeats every three months. The recurrence end. This optional parameter is an instance of the EKRecurrenceEnd class, which indicates when the recurrence rule ends. The recurrence end can be based on a specific end date or on an amount of occurrences. If you don’t want to specify an end for the recurrence rule, pass nil. Create a Complex Rule You can create a recurrence rule with a complex pattern using the init(recurrenceWith:interval:daysOfTheWeek:daysOfTheMonth:monthsOfTheYear:weeksOfTheYear:daysOfTheYear:setPositions:end:) method. As for a basic recurrence rule, you provide a frequency, interval, and optional end for the recurring event. In addition, you can provide a combination of optional values describing a custom rule, as listed in the table below.  |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |  You can provide values for any number of the parameters in the table. Parameters that don’t apply to a particular recurrence rule are ignored. If you provide a value for more than one of the parameters, the recurrence occurs only on days that apply to all provided values. Once you have created a recurrence rule, you can apply it to a calendar event or reminder with the addRecurrenceRule(_:) method of EKCalendarItem.

## See Also

### Recurrence

- [EKRecurrenceDayOfWeek](eventkit/ekrecurrencedayofweek.md)
- [EKRecurrenceEnd](eventkit/ekrecurrenceend.md)
- [EKRecurrenceRule](eventkit/ekrecurrencerule.md)