# Recurring Events Basics

The Kendo UI for Angular Scheduler provides support for recurring events on a daily, weekly, monthly, and annual basis, and allows for exceptions from these recurrence rules.

## Creating Recurring Events

To create a repeating event, select **Make recurring** in the Edit Dialog and choose one of the following options:

* Daily—the event repeats every day. Optionally, an interval can be set to repeat every N days.
* Weekly—the event repeats on each of the selected weekdays. Optionally, an interval can be set to repeat every N weeks.
* Monthly—the event repeats every month or every N months:
  * On a set date.
  * On a set position—first, second, third or fourth day or set weekday.
* Yearly—the event repeats every year or every N years:
  * On a set date.
  * On a set position in a given month—every first, second, third or fourth day or set weekday.

By default, an event will repeat forever. An end condition can be set to limit the duration of the series:

* After a set number of occurrences—repeat exactly N times.
* On an end date—repeat until the set date. Events that occur on the set date will be included in the series.

The editor shows a localized summary below **Edit recurrence**. Long summaries are limited to two lines, with the full text in a tooltip. The content can be customized with a [recurrence summary template](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/templates#recurrence-summary-template).

The daily meeting below has two rescheduled occurrences.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/scheduler/recurring/editing/source.txt)

### Modifying Recurring Events

In the [event overview](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/editing#event-overview) popover, the **Edit** menu offers the current occurrence or the whole series.

Upon double-clicking a repeating event, the user is prompted to specify the desired action:

* Edit current occurrence—edits the selected occurrence from the series.
* Edit the series—edits all occurrences.

  ![Edit confirmation dialog](https://www.telerik.com/kendo-angular-ui-develop/components/assets/a42daa116ba30e1b7041da75c3450594/edit-confirmation-dialog.png)

When you save a series that has individually edited occurrences, the Scheduler asks whether to keep or reset them:

* **Keep custom events**—keeps the individually edited occurrences as they are.
* **Reset custom events**—deletes the individually edited occurrences, so all occurrences match the updated series.
* **Cancel**—returns to the edit dialog without saving.

The same choice applies when you remove the recurrence from such a series. **Keep custom events** turns the edited occurrences into standalone events.

When you close the edit dialog with unsaved changes, the Scheduler asks you to confirm before it discards them.

The same edit prompt is also displayed when resizing or moving recurring events. When you move or resize the whole series and it has individually edited occurrences, the Scheduler also asks whether to keep or reset them.

The built-in editing directives handle these choices. For manual updates, the [`SaveEvent.keepCustomEvents`](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/api/saveevent#keepcustomevents) property can be passed to the [`BaseEditService.update`](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/api/baseeditservice#update) method.

### Deleting Recurring Events

In the [event overview](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/editing#event-overview) popover, the **Delete** menu offers the current occurrence or the whole series.

Upon deleting a repeating event, the user is prompted to specify the desired action unless the event overview popover already provides the scope:

* Delete current occurrence—removes the selected occurrence from the series.
* Delete the series—removes all occurrences.

> Recurrence exceptions will be removed if the user delete the series.

![Edit confirmation dialog](https://www.telerik.com/kendo-angular-ui-develop/components/assets/31f5abc5bb4f8b3271854e1af28bde1c/delete-confirmation-dialog.png)

## Glossary of Terms

* Recurring Event—an event that repeats on a set interval.
* Recurrence Rule—a textual representation of the rules by which an event repeats. See [Recurrence Rules](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/recurring-events/recurrence-rules) for details.
* Recurrence Series—a repeating event and all of its occurrences, including modified events.
* Recurrence Exception—a date on which the repeating event does not occur.
  * The same term is also to describe a modified event from a recurrence series.
* Occurrence—a copy of a repeating event that occurs on a specific date.

## Suggested Links

* [Angular Scheduler Overview](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler)
* [Data Binding](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/data-binding)
* [Data Binding of Recurring Events](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/recurring-events/data-binding)
* [Recurrence Rules](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/recurring-events/recurrence-rules)
* [API Reference of the SchedulerComponent](https://www.telerik.com/kendo-angular-ui-develop/components/scheduler/api/schedulercomponent)