> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recurring events

> Create events that repeat on a schedule, and edit or delete a single occurrence or the whole series.

## Overview

A recurring event repeats automatically on a schedule (a daily standup, a weekly one-on-one, a monthly review), so you create it once instead of adding it over and over. You set the repeat when you create or edit an event, and Custral shows every occurrence on the [Calendar](/comms/calendar/overview) grid.

## How it works

Recurring events are configured with the **Repeat** control in the event editor. It offers quick presets (**Daily**, **Weekly on {weekday}**, **Monthly**, **Annually**) plus a **Custom…** option for anything else: repeat every N days/weeks/months/years, pick specific weekdays for a weekly rule, and choose when the series ends (never, on a date, or after a number of occurrences).

Each occurrence appears as its own event on the grid, marked with a small repeat glyph (↻) so you can tell a series apart from a one-off. Under the hood the whole series is anchored to one "master" event; the individual occurrences you see and click are expanded from it for the dates currently in view.

Because a series has both a master and individual occurrences, editing or deleting a recurring event asks **which** you mean:

* **This event**: changes or removes only the occurrence you clicked, leaving the rest of the series untouched.
* **This and following events**: changes or removes the occurrence you clicked and every later one, while keeping the past occurrences. (The series is truncated at that point; editing creates a new series from there with your changes.)
* **All events in the series**: changes or removes every occurrence, including the repeat rule itself.

## Using it

<Steps>
  <Step title="Make an event repeat">
    Create or open an event, then set **Repeat** to a preset (for example **Weekly on Wednesday**). Save, the event now
    appears on each scheduled date with the ↻ marker.
  </Step>

  <Step title="Build a custom schedule">
    Choose **Custom…** in the Repeat control. Set the interval (e.g. every 2 weeks), pick the weekdays for a weekly
    rule, and choose how it **Ends**: never, on a specific date, or after a set number of occurrences.
  </Step>

  <Step title="Edit one occurrence, this-and-following, or the whole series">
    Open a recurring event and edit it as usual. On save, choose **This event** (just that occurrence), **This and
    following events** (this one and every later one), or **All events in the series** (every occurrence, including the
    repeat rule).
  </Step>

  <Step title="Delete one occurrence, this-and-following, or the whole series">
    Delete a recurring event and choose **This event**, **This and following events**, or **All events in the series**.
  </Step>
</Steps>

## Troubleshooting

| Symptom                                                                     | Likely cause                                                                                    | What to check                                                                                                            |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Editing one occurrence changed the whole series                             | **All events** was chosen at the prompt                                                         | Re-open the series; choose **This event** to change only one occurrence                                                  |
| Changing the repeat schedule "didn't stick"                                 | The edit was scoped to **This event**                                                           | A single occurrence can't change the rule. Edit and choose **This and following events** or **All events in the series** |
| After **This and following**, the future events look like a separate series | That's expected. The original series is truncated and a new one is created from the split point | The past occurrences stay on the old series; the changed ones live on the new one                                        |
| Deleting removed more than expected                                         | **All events** was chosen at the delete prompt                                                  | Choose **This event** to remove a single occurrence                                                                      |
| A recurring event only shows once                                           | Occurrences only render for the visible date range                                              | Navigate to the dates you expect; occurrences expand per view                                                            |
| No ↻ marker / occurrences missing                                           | The event's calendar is toggled off, or the change hasn't synced                                | Enable the calendar in **My Calendars**; confirm the connection is still authorized                                      |
| A custom series ends a day early or late                                    | The **On** end date is the last day the series runs                                             | Adjust the end date; for a fixed count use **After N occurrences** instead                                               |
| Multi-day all-day series looks off by a day                                 | Provider date handling for all-day spans                                                        | Verify the start and end dates on the source calendar                                                                    |

<Note>
  When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server
  logs.
</Note>

## Related

* [Calendar](/comms/calendar/overview): connect calendars, create events, and set meeting providers.
* [Email scheduling](/comms/email/scheduling): defer email sends to a chosen time.
* [Nylas integration](/integrations/nylas): the email/calendar connection layer.


## Related topics

- [Responding to invites](/comms/calendar/responding-to-invites.md)
- [Calendar](/comms/calendar/overview.md)
- [Automations](/automation/overview.md)
- [Cohorts](/data/collections/stack.md)
- [Events](/dev/events.md)