Migrate data from Exchange

Google Workspace Migration for Microsoft Exchange

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

  1. Meet the system requirements—For details, go to GWMME system requirements.
  2. 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)
  3. 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

  1. Go to the GWMME download page.
  2. Click Download GWMME.
  3. 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 details

Depending on the version of Outlook you’re using, you might not see all the fields in this step.

  1. Click Startand thenGoogle Workspace Migrationand thenGoogle Workspace Migration for Microsoft Exchange.
  2. For Server Type, select Exchange.
  3. 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.
  4. If you’re migrating from other versions of Exchange:
    1. 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
    2. Click Admin username and enter the username for the Exchange admin account that you want to use to open your users' mail stores.
  5. Click Next.
2. Enter user & domain information
  1. 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.

  2. For Service account credentials file, enter the path to the JSON file created as part of the authorization process.
  3. For Google Workspace admin user, enter the full email address of your Google Workspace super administrator account.
  4. Click Next.
3. Review migration settings
  1. Check the box next to each type of data that you want to migrate.
  2. 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.
  3. 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
  4. Click Next.
  5. 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.

  6. Click Nextand thenStart.

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.

Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu