Copy your Gmail mailboxes from Google to Exchange Online in your Microsoft 365 tenant with ShareGate's Copy from Gmail feature.
Copy from Gmail is only available as a beta public preview.
You can email our product manager at ryan.hum@workleap.com with your machine code to request access to our Copy from Gmail beta.
Prerequisites
You have Google Workspace Super admin permissions.
You have global admin permissions in your Microsoft 365 destination.
Your destination users have a valid Microsoft license.
Permissions consent
When you first connect to your Microsoft 365 and Google Workspace environment, you must consent to several permissions for each service.
To review the Google Workspace required permissions, see Required permissions to use Copy from Gmail.
Microsoft 365 permissions are handled through the Azure ShareGate migration tool application. Copy from Gmail and Copy mailboxes, use a version that requires consent to additional application permissions.
To review the Microsoft 365 permissions (including application permissions), see Which permissions does the Azure ShareGate migration tool application need?
Note: If you encounter an issue with app consent, 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 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 your first connection, a browser window is opened, and you must consent to a set of permissions. Follow the on-screen instructions to accept the permissions and return to Migrate.
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 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 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 for mailbox migrations.
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 the 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 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 might have occurred so you can solve 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. 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.
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 run into any problems during your initial migration, running an incremental migration is the first thing we recommend attempting to solve these issues.