# 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](/features/data-migrations-with-movebot.md) as a precursor to reading this.&#x20;

#### **Supported Systems:**

* [Google Workspaces Gmail](/connections/google-workspaces-gmail.md)
* [Outlook Online (Office 365) EWS](/connections/outlook-online-office-365-ews.md)
* [Exchange Server](/connections/exchange-server.md)

## 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](/features/mail-migrations-with-movebot.md).

### 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 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.movebot.io/features/calendar-migrations-with-movebot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
