IMAP migration in the Microsoft 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 Microsoft 365 admin center, go to Setup > 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.


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.

Before you migrate, read What you need to know about migrating your IMAP mailboxes to Office 365.

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

To migrate Exchange mail to Office 365, see Use express migration to migrate Exchange mailboxes to Office 365

Migrate IMAP mailboxes to Office 365

  1. Sign into the About the Microsoft 365 admin center.

  2. Navigate to Setup > Data migration.

    Data migration dashboard

    Select your data service dashboard opens.

    Select your email service

  3. Do one of the following steps:

    • Your provider is listed:

      • Choose the email provider you are migrating from.


        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.


        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 Create DNS records at Google Domains for Office 365 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.

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

Prepare your or account for IMAP migration