Copy your Gmail mailboxes to a Microsoft 365 tenant with ShareGate's Copy from Gmail feature, available with ShareGate Migrate Pro and Migrate Enterprise.
To learn how to upgrade your ShareGate license, see Upgrade or renew your subscription.
Note: Copy from Gmail comes with a few restrictions; we recommend reading the Copy from Gmail - Limitations article before running a Gmail migration.
Prerequisites
You have a Migrate Pro or Migrate Enterprise subscription.
You have Google Workspace Super admin permissions.
You have global admin or Exchange admin permissions in your Microsoft 365 destination.
Your destination users have a valid Microsoft license.
Required Microsoft 365 permissions
A global admin must consent to a Microsoft 365 permission scope once before using Copy from Gmail.
Consent can be granted when a global admin connects to their tenant while using Copy from Gmail, or it can be granted beforehand to allow an Exchange admin to perform the migration.
To learn about the required permissions for mailbox migrations, see Microsoft 365 permission scopes required for ShareGate.
To learn how a global admin can grant consent to these permissions, see How a global or privileged role admin can consent to ShareGate's Microsoft 365 permission scopes.
How-to
Select Copy from the sidebar.
Select the Copy mailboxes tab.
Click Copy from Gmail.
Select your source Google Workspace in the top-left connection box, or click + Add connection to connect to a new one.
If this is the first connection, a browser window is opened, and you must consent to a set of Google permissions.
Place a check mark 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 to filter by available mailbox type.
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.
If this is the first time connecting to the tenant with a mailbox migration feature, you will get prompted to consent to a Microsoft 365 permission scope as described in the Permissions consent section above.
You can click the refresh icon to update your users.
Adjust your copy options.
Click Continue to mailbox mapping.
Map your mailboxes.
Click Continue to recipient mapping.
Map your recipients.
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 get a warning about problematic on-hold destination mailboxes, you can click Export list of on-hold mailboxes to export a CSV report of the problematic mailboxes and see the article Detect and fix mailbox migration issues with hold and retention policy settings for a solution.
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 from Gmail. 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. 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 may have occurred so that you can resolve these issues.
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. For multi-session migrations, 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.
ShareGate Migrate memorizes your Gmail migrations and their mappings to keep track of what items to increment or copy as new.
To run an incremental copy, you must run a new migration with the same mappings as your original migration from the same instance of ShareGate Migrate as your first migration.
Tip: If you encounter any problems during your initial migration, we recommend attempting to resolve these issues by running an incremental migration first.