Migrate email with the data migration service

Option 1: Set up Exchange Online

Before you begin: Complete the steps in Prepare your source account: Exchange Online.

1. For Migration Start Date, accept the option that appears or choose a start date for your migration.
2. For Migration Options, accept the options that appear or choose to exclude some data.
3. Click Select Users.

Option 2: Set up other versions of Exchange

Before you begin: Complete the steps in Prepare your source account: Exchange 2007 or later.

1. Sign in with a super administrator account to the Google Admin console.

   If you aren’t using a super administrator account, you can’t complete these steps.

2. Go to Menu  Data > Data import & export > Data Migration (New).
3. Click Go to classic migration service.
4. Click Set up data migration.
5. For Migration Source, select your version of Exchange.

   Then, select Email as the data type.

6. For Connection Protocol, choose an option:
   • Auto Select (Recommended)
   • Exchange Web Services (EWS) and in the Server URI field, enter your EWS server name (for example, https://outlook.office365.com/EWS/Exchange.asmx)
7. For Role Account, enter the email address and password for your role account.
8. Click Start.
9. (Optional) If the connection was unsuccessful, verify that the role account and connection protocol information is correct. Then, click Start again.
10. For Migration Start Date, accept the option that appears or choose a start date for your migration.
11. For Migration Options, accept the options that appear or choose to exclude some data.
12. Click Select Users.

Migrate email for a single user

1. Click Add user.
2. For Source Email, enter the user's email address on the source account.
3. For Google Workspace Email, start entering the user's new email address and choose from the list of suggested users.
4. Click Start.
5. (Optional) To migrate another user's email, repeat these steps.

Migrate email for multiple users

1. Click Bulk upload with csv.
2. Click Attach File to upload the migration CSV file containing the legacy email addresses and the new email addresses.
   Include only those addresses that you want to migrate in the CSV file (this can be all or just some of the addresses on your server). For details on how to format the file, go to Use CSV files with the data migration service.
3. Click Upload and Start Migration.
4. If there are errors in your file, choose an option:
   • To update the file, click Cancel. Then, upload the updated file.
   • To ignore the incorrect mappings, check the Ignore errors box.

Before you begin: Complete the steps in Prepare your source account: IMAP server. 

1. Sign in with a super administrator account to the Google Admin console.

   If you aren’t using a super administrator account, you can’t complete these steps.

2. Go to Menu  Data > Data import & export > Data Migration (New).
3. Click Go to classic migration service.
4. For Migration Source, select Other IMAP Server.

   Make sure Email is selected as the data type.

5. For Connection Protocol, choose an option:
   • Auto Select (Recommended)
   • IMAP and in the Server URI field, enter your IMAP server name (for example, imap.example.com)

     For help with this, go to Connection information for common IMAP-based webmail providers.

6. For Role Account, enter the email address and password for your role account.
7. Click Start.

   Important: If you're redirected to the new data migration service after you click Start, you need to finish the migration in the new tool. Go to and complete the steps in Run a migration. 

   If you're not directed to the new tool, continue with step 8.

8. (Optional) If the connection was unsuccessful, verify that the role account and connection protocol information is correct. Then, click Start again.
9. For Migration Start Date, accept the option that appears or choose a start date for your migration.
10. For Migration Options, accept the options that appear or choose to exclude some data.
11. Click Select Users.

Important: If you attempt to add a single user or bulk users to an existing migration, you'll be redirected to the new data migration service. To set up a migration in the new service, follow the steps in Run a migration.

Migrate email for a single user

1. Click Add user.
2. In the Source Email field, enter the user's email address on the source account.
3. For Google Workspace Email, start entering the user's new Google Workspace email address and choose from the list of suggested users.
4. For Password, enter the user's password for their source email account.
5. Click Start.
6. (Optional) To migrate another user's email, repeat these steps.

Migrate email for multiple users

1. Click Bulk upload with csv.
2. Click Attach File to upload the migration CSV file containing the legacy email addresses and the new Google Workspace email addresses.

   For details on how to format the file, go to Use CSV files with the data migration service.

3. Click Upload and Start Migration.
4. If there are errors in your file, choose an option:
   • To update the file, click Cancel. Then, upload the updated file.
   • To ignore the incorrect mappings, check the Ignore errors box.

If your provider isn't listed here, check your provider's documentation for this information. Also, make sure your username and password are close at hand.

Before you begin: Complete the steps in Prepare your source account: Existing Google Workspace account.

Perform the following steps on your target Google Workspace domain (the account you're migrating to):

1. Sign in with a super administrator account to the Google Admin console.

   If you aren’t using a super administrator account, you can’t complete these steps.

2. Go to Menu  Data > Data import & export > Data Migration (New).
3. Click Go to classic migration service.
4. For Migration Source, select Google Workspace.
5. Click Start.

   Important: If you're redirected to the new data migration service after you click Start, you need to finish the migration in the new tool. Go to and complete the steps in Run a migration.

   If you are not directed to a new page, continue with step 6.

6. For Migration Start Date, accept the option that appears or choose a start date for your migration.
7. For Migration Options, accept the options that appear or choose to exclude some data.
8. Click Select Users.

Perform the following steps on your target Google Workspace domain (the account you're migrating to).

Important: If you attempt to add a single user or bulk users to an existing migration, you'll be redirected to the new data migration service. To set up a migration in the new service, follow the steps in Run a migration.

Migrate email for a single user

1. Click Add user.
2. For Source Email, enter the user's Google Workspace email address on the source account.
3. For Google Workspace Email, start entering the user's new Google Workspace email address and choose from the list of suggested users.
4. For Password field, enter the user's password for their source email account.
5. Click Start.
6. (Optional) To migrate another user's email, repeat these steps.

Migrate email for multiple users

1. Click Bulk upload with csv.
2. Click Attach File to upload the migration CSV file containing the legacy email addresses and the new Google Workspace email addresses.

   For details on how to format the file, go to Use CSV files with the data migration service.

3. Click Upload and Start Migration.
4. If there are errors in your file, choose an option:
   • To update the file, click Cancel. Then, upload the updated file.
   • To ignore the incorrect mappings, check the Ignore errors box.

Before you begin: 

• Complete the steps in Prepare your source account: Personal Gmail account.
• Have the user whose data you're migrating available to sign in to their Gmail account and allow you to migrate data. After they authorize, you have 10 minutes to enter the user's new email address and start the migration before the authorization expires.

Then, complete the following steps:

1. Sign in with a super administrator account to the Google Admin console.

   If you aren’t using a super administrator account, you can’t complete these steps.

2. Go to Menu  Data > Data import & export > Data Migration (New).
3. Click Go to classic migration service.
4. For Migration Source, select Gmail.
5. Click Start.
6. For Migration Start Date, accept the option that appears or choose a start date for your migration.
7. For Migration Options, accept the options that appear or choose to exclude some data.
8. Click Select UsersAdd user.
9. For Source Email, enter the user's Gmail address.
10. Click Authorize.
    • The Gmail account owner is prompted to sign in to Gmail.
    • The Gmail account owner must review the request for permission to view and manage their mail and click Allow.
11. For Google Workspace Email, start entering the user's new Google Workspace email address and choose from the list of suggested users.
12. Click Start.

    You have 10 minutes to enter the user's new email address and start the migration before the authorization expires.

13. (Optional) To migrate Gmail for another user, repeat these steps.