# Calendar Migrations with Movebot

## Introduction

Movebot takes an unusual approach to calendar migrations, using the same mechanics of storage migrations for mail, calendar, and contacts. Because of this, we recommend that you read through [data-migrations-with-movebot](https://docs.movebot.io/features/data-migrations-with-movebot "mention") as a precursor to reading this. 

#### **Supported Systems:**

* [google-workspaces-gmail](https://docs.movebot.io/connections/google-workspaces-gmail "mention")
* [outlook-online-office-365-ews](https://docs.movebot.io/connections/outlook-online-office-365-ews "mention")
* [exchange-server](https://docs.movebot.io/connections/exchange-server "mention")

## Quick Start Guide

Because transferring or migrating calendar data uses the same process as emails and contacts, simply follow the existing guide for [Mail Migrations](https://docs.movebot.io/features/mail-migrations-with-movebot).

### Enable Calendar Migration

1. Navigate to your Movebot project.
2. Go to Settings → Options.
3. Enable checkbox for "**Include Calendars**"

### Configure Extended Mappings

Extended Mappings define how attendee email addresses should be rewritten and ensure that destination calendar events correctly reflect the intended participants.\
\
Configuring Extended Mappings is a required part of calendar migrations.\
\
Once calendar migration is enabled, you will see the option to configure Extended Mappings as an additional step in your project settings.

**Mapping Examples:**

| Scenario                           | Source Mapping            | Destination Mapping   |
| ---------------------------------- | ------------------------- | --------------------- |
| Same Domain and Username           | \*@domain.com             | \*@domain.com         |
| Domain Change (Username Unchanged) | \*@old-domain.com         | \*@new-domain.com     |
| Domain and Username Change         | <john.doe@old-domain.com> | <jdoe@new-domain.com> |

#### Advanced Calendar Settings

{% hint style="danger" %}
These settings should not be adjusted unless explicitly instructed by our support staff.
{% endhint %}

| Setting                                      | Description                                                                                | Default  |
| -------------------------------------------- | ------------------------------------------------------------------------------------------ | -------- |
| Include External Events                      | Copy events where the migrating user was an attendee (but not the owner).                  | Enabled  |
| Send Invitations to Attendees                | Sends calendar invites to destination users after migration.                               | Disabled |
| Include External Shared Calendars            | Copies shared calendars as static snapshots. Does not preserve live sharing functionality. | Disabled |
| Ignore Events Older Than 7 Days (**legacy**) | Limits migration to only recent events.                                                    | Disabled |