Migrate email with the data migration service

Supported editions for this feature: Business Starter, Standard, and Plus; Enterprise; Education and Enterprise for Education; Nonprofits; G Suite Basic and Business; Essentials.  Compare your edition

If you have Essentials edition, you can only migrate contacts. You can't migrate email or calendar data.

If you're migrating to Google Workspace, you can migrate email using the data migration service.

Before you begin

You must be signed in as a super administrator for this task.

Is my legacy environment supported?

You can migrate email using the data migration service, if your legacy environment is listed below.

Legacy environment For migration details, go to...
Microsoft Exchange Server 2003, 2007, 2010, 2013, 2016, or Exchange Online (Office 365) Migrate email from Exchange or Exchange Online
A webmail provider that uses the IMAP protocol, such as 1&1 IONOS, AOL, Apple iCloud, Bluehost, Yahoo!, or Zoho Migrate email from IMAP-based webmail providers
Another Google Workspace account Migrate email from Google Workspace
A personal Gmail (@gmail.com) account Migrate data from Gmail
Set up your legacy environment (required)

Before you can use the data migration service, you need to prepare the environment you're migrating from.

Note: While the data migration service used to require allowing less secure apps to access accounts, it's no longer required.

Migrate email from Exchange or Exchange Online

Step 1: Set up the data migration service

Option 1: Set up Exchange Online

  1. Make sure you have completed the steps in Set up your legacy system: Exchange Online.
  2. Under Migration Start Date, accept the option that appears or choose a start date for your migration.
  3. Under Migration Options, accept the options that appear or choose to exclude some data.
  4. Click Select Users.

Option 2: Set up other versions of Exchange

  1. Sign in to your Google Admin console.

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

  2. From the Admin console Home page, go to Data migration.
  3. Click Set Data Migration Up.
  4. Under Migration Source, select your version of Exchange.

    Then, select Email as the data type.

  5. Under 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. Under Role Account, enter the email address and password for your role account.
  7. Click Start.
  8. (Optional) If the connection was unsuccessful, verify the role account and connection protocol information is correct. Then, click Start again.
  9. Under Migration Start Date, accept the option that appears or choose a start date for your migration.
  10. Under Migration Options, accept the options that appear or choose to exclude some data.
  11. Click Select Users.
Step 2: Migrate email from Exchange

Migrate email for a single user

  1. Click Add user.
  2. In the Source Email field, enter the user's legacy email address.
  3. In the Google Workspace Email field, 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.

    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 Moreand thenExit migration.

Migrate email from IMAP-based webmail providers

Step 1: Set up the data migration service
  1. Sign in to your Google Admin console.

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

  2. From the Admin console Home page, go to Data migration.
  3. Click Set Data Migration Up.
  4. Under Migration Source, select GoDaddy IMAP or Other IMAP Server.

    Make sure Email is selected as the data type.

  5. Under Connection Protocol, choose an option:
  6. Under Role Account, enter the email address and password for your role account.
  7. Click Start.
  8. (Optional) If the connection was unsuccessful, verify the role account and connection protocol information is correct. Then, click Start again.
  9. Under Migration Start Date, accept the option that appears or choose a start date for your migration.
  10. Under Migration Options, accept the options that appear or choose to exclude some data.
  11. Click Select Users.
Step 2: Migrate email from IMAP-based webmail providers

Migrate email for a single user

  1. Click Add user.
  2. In the Source Email field, enter the user's legacy email address.
  3. In the Google Workspace Email field, start entering the user's new Google Workspace email address and choose from the list of suggested users.
  4. In the Password field, enter the user's password for their legacy 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 Moreand thenExit migration.

Connection information for common IMAP-based webmail providers

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.

Webmail provider IMAP server name
123 Reg imap.123-reg.co.uk
1&1 IONOS
  • imap.ionos.com
  • imap.ionos.co.uk
  • imap.ionos.fr
  • imap.1and1.com
AOL imap.aol.com
Apple iCloud imap.mail.me.com
Bluehost

mail.example.com (where example.com is your domain name)

DreamHost imap.dreamhost.com
Fastmail imap.fastmail.com
Gandi.net mail.gandi.net
HostGator gator####.hostgator.com (where #### is your HostGator server name on the left hand of the cPanel)
Locaweb email-ssl.com.br
Namecheap mail.privateemail.com
one.com imap.one.com
Outlook, Hotmail, and MSN imap-mail.outlook.com
OVHcloud ssl0.ovh.net
Rackspace secure.emailsrvr.com
Yahoo! (including Yahoo! Small Business)

imap.mail.yahoo.com

Yandex
  • imap.yandex.ru
  • imap.yandex.com
Zoho
  • imap.zoho.com (For personal users with a username@zoho.com email address)
  • imappro.zoho.com (For organization users with a you@your-company.com domain-based email address)

Migrate email from Google Workspace

Step 1: Set up the data migration service

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

  1. Sign in to your Google Admin console.

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

  2. From the Admin console Home page, go to Data migration.
  3. Click Set Data Migration Up.
  4. Under Migration Source, select Google Workspace.
  5. Click Start.
  6. Under Migration Start Date, accept the option that appears or choose a start date for your migration.
  7. Under Migration Options, accept the options that appear or choose to exclude some data.
  8. Click Select Users.
Step 2: Migrate email from another Google Workspace account

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. In the Source Email field, enter the user's legacy Google Workspace email address.
  3. In the Google Workspace Email field, start entering the user's new Google Workspace email address and choose from the list of suggested users.
  4. In the Password field, enter the user's password for their legacy 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 Moreand thenExit migration.

Migrate data from Gmail

Set up and migrate from Gmail
  1. Sign in to your Google Admin console.

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

  2. From the Admin console Home page, go to Data migration.
  3. Click Set Data Migration Up.
  4. Under Migration Source, select Gmail.
  5. Click Start.
  6. Under Migration Start Date, accept the option that appears or choose a start date for your migration.
  7. Under Migration Options, accept the options that appear or choose to exclude some data.
  8. Click Select Users.
  9. Click Add user.
  10. In the Source Email field, enter the user's Gmail address.
  11. In the Google Workspace Email field, start entering the user's new Google Workspace email address and choose from the list of suggested users.
  12. 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.
  13. Copy the authorization code and paste in the Authorization Code field.

    Note: You have 10 minutes to copy and paste the code before it expires.

  14. Click Start.
  15. (Optional) To migrate Gmail for another user, repeat these steps.

Migration tips


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?

Need more help?

Sign in for additional support options to quickly solve your issue