Copy your Microsoft 365 mailboxes from tenant to tenant with ShareGate's Copy mailboxes feature, available with ShareGate Migrate Pro and Migrate Entreprise.
To learn more about what's in the works and what's under consideration for Copy mailboxes and ShareGate, see our Product portal.
Notes:
You can only copy mailboxes from a Microsoft 365 source tenant to a different Microsoft 365 destination tenant. Other services like Gmail and Slack are not currently supported.
Copy mailboxes comes with a few restrictions; we recommend reading the Copy mailboxes limitations and best practices articles before running a mailbox migration.
PowerShell commands are not currently available.
To use Copy mailboxes, you need ShareGate Migrate Pro or Migrate Entreprise. To upgrade your subscription, see Upgrade or renew your subscription.
Prerequisites
You have global admin permissions at the source and destination.
You have a ShareGate license with mailbox migration support.
Your mailbox users have a valid Microsoft license.
The Azure ShareGate migration tool application is consented for your tenant.
App permissions specific to Copy mailboxes are required. To consent to these permissions, ShareGate Migrate will prompt you to accept a version of the Azure ShareGate migration tool app that includes these permissions when you sign in to your tenant with Copy mailboxes for the first time.
If you have issues with app consent when using Copy mailboxes, you can try to remove the Azure ShareGate migration tool app and use this link to the Microsoft sign-in page to consent to the Azure app for Copy mailboxes.
How-to
Select Copy from the sidebar.
Select the Copy mailboxes tab.
Click Copy mailboxes.
Click the tenant selection box. It will say No connections if no tenants are connected with Copy mailboxes.
Select your source tenant or click + Add connection to add a new tenant.
If you're adding a connection, connect to your tenant with your Microsoft 365 global admin account.
If you are connecting to your tenant for the first time, you must consent to a new version of the Azure ShareGate migration tool application that includes app permissions.
You can click the refresh icon to update your users.
Place a checkmark next to each mailbox you want to migrate.
You can use the search bar to find specific mailboxes.
Click on the Filter by icon in the Mailbox type column header to filter by User or Shared mailboxes.
You can select all your listed mailboxes with the check box in the Mailbox column header.
Click Continue to select destination.
Select your destination tenant or connect to a new one. The same conditions as step (5) apply.
You can only copy mailboxes to another tenant.
Click Continue to mailbox mapping.
Click Continue to recipient mapping.
Click Continue to copy summary.
Review the summary of your operation.
You can click Export list under Selected mailboxes to export a CSV of all the mailboxes you are copying.
If you want to change your copy options and mappings, use the breadcrumb at the top to return to them. You will have to re-select all your options from the point you select.
Click Start copy or Save for later if you want to keep your migration parameters for another time.
With Save for later, you are prompted to resume your saved session the next time you launch Copy mailboxes. At that point, you can only continue from a saved session or discard it to start a different migration.
When you start your migration, you are taken to the copy summary report, where you can monitor your operation's progress.
Click Export report to download a detailed report of the copy operations to your drive. You can always retrieve your summary and detailed report from Tasks in ShareGate Migrate.
Detailed copy report
The detailed report provides valuable information about your migration operation. It allows you to review any warnings or errors that might have occurred so you can solve these issues for your users.
The copy report is exported as a zip file (.zip) and contains:
A summary file - This CSV file includes key details about the migration operation, including the start and end times, user names, source and destination email addresses, statuses of each mailbox copied, warnings, errors, and links to individual mailbox reports. The summary is named 01-Summary - task name.csv.
Individual reports for each mailbox included in the copy operation - Each mailbox report is named source_user_email_address.csv. In cases where there is a multi-session migration, the individual reports are organized in a separate folder for each session. Reports with more than 500,000 rows are split into multiple files.
To review errors and warnings, you can filter the Status column or your mailbox report in Excel to focus on these items. You can then look at the Details, Errors, and Warnings columns for details about what happened.
Incremental copy
You can use incremental copy for mailboxes previously migrated with ShareGate Migrate.
For more information, see Copy mailboxes - Incremental.
Tip: If you run into any problems during your initial migration, running an incremental migration is the first thing we recommend attempting to solve these issues.