IMAP migration in the Office 365 admin center

After you've added your users to Office 365, you can use Internet Message Access Protocol (IMAP) to migrate email for those users from their IMAP-enabled email servers.

In the Office 365 admin center, go to Users > Data migration to start migrating IMAP enabled emails. The email migrations page is pre-configured for migrations from Gmail, Outlook, Hotmail and Yahoo. You can also enter your own IMAP server name and connection parameters to migrate from an email service that is not listed.

Important: Before you can use an IMAP migration for your users, they must have been first added to your Office 365 tenant. For instructions, see Add users to Office 365 for business.

To perform an IMAP migration by using the Exchange admin center (EAC), seeMigrate other types of IMAP mailboxes to Office 365.

To use the Setup wizard, see Use the Office 365 Setup wizard to perform an IMAP migration.

Migrate IMAP mailboxes to Office 365

  1. Sign into the Office 365 admin center.

  2. Navigate to Users > Data migration.

    Data migration dashboard

    Select your data service dashboard opens.

    Select your email service
  3. Your provider is listed:   

    • Choose the email provider you are migrating from.

      Important: If you're migrating email from Gmail, you need to ask your users to create an app password you will have to use instead of their account password.

      If you're migrating email from or, you need to ask your users to set up two-step verification and obtain an app password. You will use their app password instead of their account password when you establish a connection between or and Office 365.

    • After you choose a provider, the Select users to start migrating email messages page will list all of your users with the source email pre-filled in.

      All your users are listed with the email pre-filled in

    Your provider is not listed:   

    1. Choose Other email sources:

    2. On the Select your data service page, fill in the appropriate IMAP connection data to test the connection. You can use any account for this.

      The example below is for a Google apps domain called, and therefore the IMAP server name is

      Because the example is for Google apps, note that the password is the 16-digit app password for the email account that is entered to verify the connection to the server.

      Important: If you're migrating email from Google Apps where you own the domain, you need to ask your users to create an app password you will have to use instead of their account password.

      Fill in IMAP server information and account info to connect
    3. Click Save to test the connection. Once the connection is verified, the Email Migration Status page will list all your added users with the email address that you provided.

  4. This and the following steps apply for both a listed email provider or "Other":   

    Check the box next to the users whose email you want to migrate, and then fill in the email alias, and the password (app password if you are migrating mail from Gmail or Google apps).

  5. Choose Start Migration after you have entered the required information.

    Choose Start Migration
  6. The migration status will be one of:

    • Starting

    • Queued

    • Syncing

    • Synced

    When the status is Synced the IMAP migration will continue to synchronize with the source email periodically until you choose Stop Migration.

    When you're done, choose Close Connection. This also allows you to start a new migration if you want to migrate emails from other providers as well.

  7. If you are migrating from Google apps where you own the domain, you need to go update the MX records for your DNS after you have completed email migration so that the mail will be sent to Office 365 mailboxes instead of Google apps. If you are migrating from another IMAP provider where you own the domain, check these instructions to find your domain provider.

    If you have migrated as a part of the setup experience, you can return to the setup. The setup steps will guide you through updating the DNS records.

See Also

Prepare your Gmail or Google Apps account for connecting to Outlook and Office 365

Prepare your or account for IMAP migration

Share Facebook Facebook Twitter Twitter Email Email

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!