As an administrator for your organization, you can migrate users' email, calendar, and contact data from your Microsoft Exchange environment to Google Workspace using Google Workspace Migration for Microsoft Exchange (GWMME).
Step 1: Before you begin
- Meet the system requirements—For details, go to GWMME system requirements.
- Set up an Outlook profile to use in Step 4 (below)–You can use a Microsoft Outlook profile with any Exchange setup. However, you must use an Outlook profile if you:
- Are migrating from Exchange 2016 or later
- Are migrating from Exchange Online (Microsoft 365). If so, you must be using Outlook 2016 or later or Outlook from Microsoft 365 (desktop version).
- Have Outlook 2016 or later installed on your GWMME computer (even if you're migrating from Exchange 2013 or earlier)
- Create CSV files—Depending on what you plan to migrate, you might need 2 CSV files:
- Control file–Determines the source users that get migrated and the Google Workspace accounts their data is migrated to.
- Mapping file–Required if you're migrating calendar data.
For details, go to Create CSV files for your migration.
Step 2: Authorize GWMME
Before you can install GWMME, you must Authorize GWMME for your account.
Step 3: Download & install GWMME
- Go to the GWMME download page.
- Click Download GWMME.
- Open the installer and follow the instructions to install GWMME.
Step 4: Migrate data
You can migrate data by running GWMME:
- On a Microsoft Windows computer, using the GWMME interface—Follow the instructions below, in this section.
- From the command line (better suited to experienced administrators)—Go to Migrate data using the command line.
Expand section | Collapse all & go to top
1. Enter Exchange server detailsDepending on the version of Outlook you’re using, you might not see all the fields in this step.
- Click Start
Google Workspace Migration
- For Server Type, select Exchange.
- If you’re migrating from Exchange Online (Microsoft 365) or Exchange 2016 or later, click Specify a profile to use for migration and select an Outlook admin profile.
- If you’re migrating from other versions of Exchange:
- Click Hostname/IP Address and enter your source domain name or the IP address of the email server where you’re migrating from. For example: smtp.example.com or 198.51.100.1.
- Click Admin username and enter the username for the Exchange admin account that you want to use to open your users' mail stores.
- Click Next.
- For Google Workspace domain name, enter the new primary Google Workspace target domain where the data will be migrated.
If you're migrating mail to a Google Workspace account with secondary domains, the target domain you enter might differ from the domain in the email addresses you’re migrating.
- For Service account credentials file, enter the path to the JSON file created as part of the authorization process.
- For Google Workspace admin user, enter the full email address of your Google Workspace super administrator account.
- Click Next.
- Check the box next to each type of data that you want to migrate.
- For File of accounts to migrate or File of folders to migrate, click More
, navigate to the mapping file created above, and then click Open.
- Review the migration settings and check the box next to each optional setting that you want to use:
- Migrate all data—Overwrites existing data during migration (duplicate messages skipped when unchecked)
- Save settings—Retains the current configuration for future use
- Run Diagnostics—Verifies the configuration before running the migration
- Estimate—Estimates the message count for the source users
- Migrate—Performs the migration
- Click Next.
- If prompted, specify the username and password for the Exchange admin account you're using to open your users' mail stores.
Tip: To skip this step in future migrations, check the Remember my password box.
- Click Next
Related topics
GWMME Admin Guide: Set up access to your Exchange or IMAP server (in English only)
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.
