Migrate email with the data migration service (2024)

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 to your GoogleAdminconsole.

   Sign in using an account with super administrator privileges(does not end in @gmail.com).

2. In the Admin console, go to MenuAccountData migration.

3. Click Set Data Migration Up.
4. For Migration Source, select your version of Exchange.

   Then, select Email as the data type.

5. 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)
6. For Role Account, enter the email address and password for your role account.
7. Click Start.
8. (Optional) If the connection was unsuccessful, verifythat 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.

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.

Tip: To exit a completed migration, click MoreExit migration.

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

1. Sign in to your GoogleAdminconsole.

   Sign in using an account with super administrator privileges(does not end in @gmail.com).

2. In the Admin console, go to MenuAccountData migration.

3. Click Set Data Migration Up.
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.
8. (Optional) If the connection was unsuccessful, verify thatthe 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.

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.

Tip: To exit a completed migration, click MoreExit migration.

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 to your GoogleAdminconsole.

   Sign in using an account with super administrator privileges(does not end in @gmail.com).

   See Also

   Migrate from Exchange or Exchange Online to Google Workspace

2. In the Admin console, go to MenuAccountData migration.

3. Click Set Data Migration Up.
4. For Migration Source, select Google Workspace.
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 Users.

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

Migrate email for a single user

1. Click Add user.
2. For Source Email, enter the user'sGoogle 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.

Tip: To exit a completed migration, click MoreExit migration.

Before you begin:

• Complete the steps in Prepare your source account: Personal Gmail account.
• Have the user whose data you're migratingavailable 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 to your GoogleAdminconsole.

   Sign in using an account with super administrator privileges(does not end in @gmail.com).

2. In the Admin console, go to MenuAccountData migration.

3. Click Set Data Migration Up.
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.

Migration tips

• If you want to know more about the data migration service, including how many users you can migrate, go to Is the data migration service right for my organization?
• If you have questions about running a migration, go toData migration service FAQ.
• To change the migration settings, you must first cancel the migration. For details, go to Cancel a migration.
• You can change the migration's speed. For details, go to Make my migration run faster.
• You can monitor the status of an individual user's migration and request a domain-level report. Refer to Monitor a migration.
• If you encounter issues during a migration, go to Troubleshoot the data migration service.