IMAP migration to Microsoft 365: a business guide — Kloudeal editorial illustration

IMAP migration to Microsoft 365: a business guide

Kloudeal Journal · Business guide

An IMAP migration to Microsoft 365 transfers email messages, but it requires preparing the accounts, ensuring access to the source, and switching the service. This guide explains the process, its limitations, and how to handle contacts, calendars, and local data separately.

Editorial review: · Reading time: 31 min

01Inventory

Accounts, folders, messages, and server access.

02Transfer

Destination mailboxes, batches, and error tracking.

03Change

DNS, validation, and data not supported by the IMAP protocol.

Contents of this guide

What you need to know before you begin

QuestionQuick answer
What does IMAP migrate?Primarily the messages and folders existing on the server.
Are contacts migrated?Not via standard IMAP migration.
Are calendars migrated?No.
Are tasks migrated?No.
Are rules migrated?Not as part of the IMAP process.
Must the destination mailbox exist?Yes. Exchange Online mailboxes must be provisioned beforehand.
Current documented maximum number of items500,000 per mailbox.
Current maximum size per message35 MB for native IMAP migration.
Are there subsequent synchronizations?Yes, approximately every 24 hours while the batch remains active.
Does the MX record move historical data?No. It only changes where new mail is delivered.
Should Google Workspace typically be migrated via IMAP?Not necessarily; Microsoft offers a more comprehensive, specific path.

Are you preparing for an email migration to Microsoft 365?

We can begin by reviewing your current provider, the number of accounts, data volume, IMAP server details, authentication methods, folder structures, DNS settings, and any data not covered by IMAP, in order to define the migration procedure before making any changes.

Analyze my IMAP migration

What an IMAP migration to Microsoft 365 resolves

An IMAP migration to Microsoft 365 transfers email that is available on the source server. Before choosing this method, it is essential to verify whether this encompasses all the content your organization requires. Contacts, calendars, rules, and data stored exclusively on local devices require a separate assessment. Otherwise, while users may find their messages in the new environment, they might still find that important information needed for their work is missing.

The inventory should document actual email addresses, source access credentials, data volume, and folder structures. It is also advisable to identify shared accounts and any applications that send email. An address used by multiple employees may require a different configuration than an individual mailbox; such decisions are part of the Exchange Online design process and are not addressed simply by copying messages.

A pilot migration involves testing a sample set that includes recent and older emails, as well as sent items and messages organized into folders. Attachments and any items flagged in the report as omitted or erroneous should be reviewed. Any discrepancies in message counts must be explained, as factors such as date filters, excluded folders, or unsupported content can affect the results. The report should enable you to identify the root cause and determine whether corrective action is necessary.

What to check when changing email reception

Copying data and switching the email service are distinct tasks. Before updating the domain service, you must ensure that recipients, alias addresses, and user access are all properly configured and ready. The plan must specify which environment receives new messages during each phase, and how email that arrives in the legacy system during the transition will be collected.

Following the switch, internal and external sending and receiving must be tested using representative recipients. Web forms, printers, and applications that rely on email should also be reviewed. If these systems continue to point to a legacy configuration, users might be able to work normally in Outlook, while certain business processes fail to send out notifications. These tests must be included as part of the project acceptance criteria.

What IMAP is and why it is used for email migration

IMAP Internet Message Access Protocol (IMAP) allows an email client to access messages stored on a server. Unlike the traditional POP3 model—where messages can be downloaded to a device and subsequently removed from the server—IMAP is designed to keep email data on the server and synchronize its status across clients. This makes it a relatively suitable protocol for retrieving messages during a migration.

Microsoft can connect to the source IMAP server, read the available folders, and copy the messages into the corresponding Exchange Online mailbox. However, IMAP is, at its core, simply an email protocol. It has no awareness of the full Exchange model. For instance, IMAP does not directly account for: Exchange calendars, “Full Access” or “Send As” permissions, rooms, resources, delegates, retention policies, or Microsoft 365 groups.

Consequently, using IMAP to migrate from a more feature-rich platform can significantly reduce the fidelity of the migration.

IMAP, POP3, and Exchange Online: key differences

FeaturePOP3IMAPExchange Online
Email stored on the serverMay not persist.Generally, yes.Yes.
Folder synchronizationLimited.Yes.Yes.
Read/unread statusMay depend on the client.Synchronized.Synchronized.
CalendarNo.Not part of the protocol.Yes.
ContactsNo.No.Yes.
TasksNo.No.Yes, depending on the applications used.
DelegationsNo.Not as a standard enterprise model.Yes.
Shared MailboxesNot its natural model.Not equivalent to Exchange.Yes.
Calendar availabilityNo.No.Yes.
Centralized administrationDepends on the provider.Depends on the provider.Microsoft 365 / Exchange Admin Center.

When an IMAP migration makes sense

IMAP is especially useful when the source system provides primarily email and lacks an API or a more comprehensive migration method.

SourceCould IMAP be a suitable fit?
Traditional email hostingYes.
cPanelYes, provided IMAP is available.
PleskYes.
DovecotYes.
CourierYes.
ZimbraIt can be used, though it is worth checking whether more than just email needs to be migrated.
KerioIt may be an option.
Custom Linux serverYes, if it provides a compatible IMAP interface.

The question is not just, “Does it have IMAP?” We must also ask: What information do we need to preserve? If we only need to migrate email and folders, IMAP may suffice. If we also need to migrate calendars, contacts, rules, delegations, or resources, we should check if a more comprehensive migration path exists.

When IMAP should not be the first choice

Exchange Server. If the source is an Exchange Server to which we have sufficient access, we should generally evaluate migration paths specific to Exchange. Using IMAP would mean treating an Exchange mailbox as a simple email repository, resulting in the loss of the ability to transfer other elements. Google Workspace. Microsoft currently offers a specific migration procedure for Google Workspace that can handle: email, calendars and contacts and certain additional capabilities.

Therefore, an organization using Google Workspace should not automatically select IMAP just because Gmail also exposes that protocol. Another Microsoft 365 tenant. An Exchange Online → Exchange Online migration should be approached as a tenant-to-tenantmigration, not via IMAP. Microsoft provides a “Cross-Tenant Mailbox Migration” feature, and there are also specialized platforms available. PST files as the actual source. If the IMAP server only retains data from the last few months, but users have years of information stored in PST files, then IMAP may not be the appropriate source.

In such cases, a combination of procedures will be required.

What is migrated via IMAP

Microsoft’s native IMAP migration is designed to copy existing items found within a user’s mail folders.

ElementIMAP migrationNote
InboxYes.Provided the content exists at the source.
SubfoldersYes.Subject to structure and compatibility.
Sent ItemsCan be migrated.Must be accessible via IMAP.
DraftsCan be migrated.If the server exposes the folder.
Deleted ItemsCan be included or excluded.Assess whether it is worthwhile.
JunkCan be excluded.Often provides no value.
Personal foldersYes.When visible via IMAP.

Not all folders have the same name. Depending on the server, we may encounter: Sent Sent Items INBOX.Sent Enviados Trash Deleted Items For this reason, the pilot should pay special attention when reviewing these specific folders.

What is not migrated via IMAP

ElementIMAPStandard handling
ContactsNo.CSV, PST, or another method.
CalendarsNo.PST, ICS, a specific tool, or recreation.
TasksNo.Evaluate the source and necessity.
Email rulesNo.Recreate where appropriate.
SignaturesNo.Independent configuration.
AutocompletionNo.It depends on the client.
DelegationsNo.Create permissions in Exchange Online.
RoomsNo.Create resource mailboxes.
Exchange Shared MailboxesNot as an object.Design the target object.
Outlook configurationNo.Client configuration.

This distinction should be explicitly stated in the project scope to prevent users from assuming that “migrating their email” means transferring every single configuration setting they see in Outlook.

Assessment: what to analyze before creating the first batch

An IMAP assessment does not have to be complicated, but it should address the questions that determine the conditions for the migration.

AreaRequired information
UsersActive, inactive, and generic accounts.
AliasesAdditional addresses.
SizeGB per mailbox.
ItemsApproximate number of messages.
Large messagesMessages approaching or exceeding the IMAP limit.
FoldersStructure and special folders.
ContactsIf they exist outside the IMAP server.
CalendarIf it exists and needs to be preserved.
PSTLocal archives.
DNSMX, SPF, DKIM, DMARC, and Autodiscover.
SMTPApplications that send email.
ClientsOutlook, Thunderbird, mobile devices, etc.

Measuring in gigabytes is not enough. A 20 GB mailbox with 30,000 messages may behave differently than an 8 GB mailbox containing 400,000 small items. In IMAP, the following factors matter: Volume, number of items, message size, number of folders, and the performance of the source server.

Analyzing the source IMAP server

Before creating the migration endpoint, we should check the server’s technical parameters.

DataExample
Hostnameimap.empresa.com
Port993 or another configured port.
EncryptionSSL/TLS, depending on the server.
AuthenticationSupported credentials.
Connection limitPer IP, user, or server.
Mailbox quotaMailbox size.
FirewallAllow necessary connections.
CertificateValid and trusted, where applicable.

Test the endpoint before migrating hundreds of users. One of the objectives of the pilot is to confirm that Microsoft 365 can consistently establish sessions and that the source server does not begin blocking connections as concurrency increases.

Credentials: a critical aspect of an IMAP migration

Microsoft must be able to authenticate against each source mailbox in order to copy its messages.

Native Microsoft CSV

The basic format currently contains:

EmailAddress,UserName,Password
usuario1@empresa.com,usuario1@empresa.com,ContraseñaOrigen
usuario2@empresa.com,usuario2@empresa.com,ContraseñaOrigen

EmailAddress Identifies the destination mailbox in Microsoft 365. UserName Identifies the account on the IMAP server. Password Contains the credential that allows the service to access the source mailbox. Is it necessary to know the passwords for all users? It depends on the server. Some systems allow the use of an administrative account with access to the mailboxes. Others require individual credentials. If the provider does not offer a compatible administrative mechanism and user credentials are not available, this issue must be resolved before the project begins.

The CSV contains sensitive information. Therefore: It should be stored only for as long as necessary, access to it must be restricted, and it should be securely deleted once it is no longer needed. Official reference: Microsoft – CSV files for IMAP migration batches.

IMAP folders: a minor detail that often causes issues

A migration process should review the folders before moving all the mailboxes. Special folders. In particular: Inbox, Sent, Drafts, Deleted, Junk, and Archive. Different names. Two servers may serve the same function while using different structures. Furthermore, some clients may have created personal folders that resemble system folders. Forward slash “/” in folder names. Microsoft’s optimization documentation specifically warns of issues with folders that contain a forward slash in their name. /.

It is advisable to identify these before the project begins and rename them where necessary. Do not migrate junk data unnecessarily. Before moving hundreds of gigabytes, consider excluding: Spam, Junk, Trash, Deleted Items, or historical folders that have no value, provided that company policy allows for it.

What happens if PST files exist, even when using IMAP?

The fact that an account is configured via IMAP does not guarantee that the entire history remains on the server. Users may have created: PST files, AutoArchive files, manual exports, or local Outlook folders. Example.

SourceHistorical data
IMAP server2021–2026
archive.pst2012–2020

A migration based solely on IMAP would leave ten years’ worth of data out of the new mailbox. If PST files are included in the scope. We can evaluate: Importing via classic Outlook, the Microsoft Purview Import Service, or another tool. Avoiding overlaps. If a PST file also contains email that is still present on the IMAP server, we will need to determine which items come from which source to minimize duplicates.

Current limitations of Microsoft IMAP migration

Microsoft currently specifies two particularly important limits.

LimitCurrent value
Maximum number of items per mailbox500.000
Maximum message size35 MB

500,000 items. Microsoft processes email from newest to oldest. Therefore, a mailbox that exceeds this number of items requires analysis before using the standard IMAP migration method. 35 MB per message. This limit applies to the IMAP migration process; it should not be confused with the various transport limits that may apply in Exchange Online after the migration.

Items exceeding these limits must be identified and handled via a different method if they need to be preserved. Verify the limits just before starting the project. Cloud service figures are subject to change. Therefore, while this guide reflects the documentation current as of the date of its last update, the runbook should be re-verified before executing an actual migration. Official reference: Microsoft – IMAP migration limitations.

Performance, concurrency, and throttling

The speed of an IMAP migration cannot be predicted based solely on internet bandwidth. At least four factors come into play.

FactorImpact
Source serverSession limits and capacity.
Microsoft Migration ServiceConcurrency and resource management.
Number of itemsProcessing of individual messages.
NetworkThroughput between services.

Do not increase concurrency without taking measurements. More connections do not necessarily mean a faster migration. In fact, the opposite may occur if the source server begins to: reject connections, apply throttling, or degrade service for users. A pilot phase helps identify the optimal balance. Microsoft recommends using test batches to determine: actual duration, the appropriate number of connections, and the optimal size for migration waves.

There is no guaranteed speed. Migration services are subject to throttling mechanisms and availability constraints. If a mailbox progresses more slowly over a certain period, it does not automatically indicate a failure. Official references:

Requirements in Microsoft 365

IMAP migration copies data into existing mailboxes.

RequirementStatus before migration
Microsoft 365 tenantAvailable.
DomainAdded and verified.
UsersCreated.
Exchange licenseAssigned.
MailboxProvisioned.
Migration endpointPrepared.
Source credentialsAvailable.
DNS accessConfirmed.

Verifying a domain does not affect email flow. You can add a domain to Microsoft 365 using the appropriate TXT record and prepare all mailboxes without yet modifying the MX record. This allows much of the work to be completed before the cutover.

Microsoft 365 licenses for Exchange Online

The user requires a license that provisions an Exchange Online mailbox.

ProfileProduct we typically evaluate
Email onlyExchange Online Plan 1
Email with greater mailbox/archiving requirementsExchange Online Plan 2
Email, Microsoft 365 web servicesBusiness Basic
Email, desktop OfficeBusiness Standard
Office, security, IntuneBusiness Premium
EnterpriseMicrosoft 365 E3/E5 or another suitable combination

Target mailbox size Microsoft currently documents, among others:

PlanPrimary mailbox
Exchange Online Plan 150 GB
Exchange Online Plan 2100 GB
Business Basic50 GB
Business Standard50 GB
Business Premium50 GB
Microsoft 365 Enterprise E3/E5100 GB, based on current configuration.

The destination mailbox must have sufficient space. If we want to move a 70 GB source to a license where the primary mailbox supports 50 GB, we must first determine: a different license, Online Archive, cleanup, or an alternative design. Official reference: Microsoft – Exchange Online Limits.

IMAP migration via the Exchange Admin Center

Migration can currently be managed from Exchange Admin Center. General path. Within the Exchange Admin Center: Migration → Add migration batch → Migrate to Exchange Online → IMAP migration. The wizard requests:

StepInformation
Batch nameBatch identifier.
Migration typeIMAP.
Migration endpointSource server.
CSVUsers and credentials.
Folder configurationInclusions/exclusions where applicable.
SchedulingLaunch and reporting.

Do not roll out to the entire company in the first batch. Although it is technically possible to load thousands of rows into a CSV, it is more manageable to divide the project into waves. This makes it easier to: control errors, analyze performance, communicate with users, and adjust concurrency. Official reference: Microsoft – Migrate other IMAP mailboxes.

Preparing the CSV file correctly

The native IMAP CSV uses three mandatory columns.

EmailAddress,UserName,Password
maria@empresa.com,maria@empresa.com,PasswordOrigen1
carlos@empresa.com,carlos@empresa.com,PasswordOrigen2

Meaning.

ColumnFunction
EmailAddressDestination Exchange Online mailbox.
UserNameSource IMAP login.
PasswordCredential for the source mailbox.

The source and destination email addresses do not have to be identical. The CSV allows the login used for the IMAP server to differ from the identity of the new mailbox. This is useful during domain reorganizations. CSV limit. Current Microsoft documentation supports up to 50,000 rows and a file size of 10 MB for a CSV file used in an IMAP migration batch.

Nevertheless, Microsoft recommends splitting large migrations into multiple batches. UTF-8. If there are special characters in the identifiers, the CSV file should be saved using the appropriate Unicode/UTF-8 encoding.

Migration endpoint: the connection between Microsoft 365 and the source

The migration endpoint defines how Microsoft 365 will connect to the IMAP server. It includes: server, port, security, and concurrency parameters.

Example

New-MigrationEndpoint `
    -IMAP `
    -Name "IMAP-Hosting" `
    -RemoteServer "imap.empresa.com" `
    -Port 993 `
    -Security Ssl

Concurrency. Settings such as the following can also be configured: MaxConcurrentMigrations and MaxConcurrentIncrementalSyncs. Do not use arbitrary values. The appropriate configuration should be determined based on the pilot phase and the limits specified by the email provider. Official reference: Microsoft – New-MigrationEndpoint.

Migration batch: organizing the migration in waves

Once the endpoint is available, you can create one or more batches.

PowerShell Example

$CsvFile = "C:\Temp\IMAP-Wave01.csv"

New-MigrationBatch `
    -Name "IMAP-Wave01" `
    -SourceEndpoint "IMAP-Hosting" `
    -CSVData ([System.IO.File]::ReadAllBytes($CsvFile)) `
    -AutoStart

Check the status

Get-MigrationBatch -Identity "IMAP-Wave01" |
    Format-List Identity,Status,TotalCount,SyncedCount

Why divide into waves?

AdvantageResult
Lower riskA failure does not affect the entire workforce.
Better diagnosticsErrors are easier to locate.
PerformanceWe can adjust concurrency.
CommunicationUsers migrated by group.
Operational rollbackSmaller scope per wave.

Incremental synchronizations: the major operational advantage of IMAP

After the initial synchronization, IMAP batches that remain active can continue copying new messages detected on the source server. Current frequency. Microsoft currently documents an incremental synchronization approximately every 24 hours. This allows for pre-migration. We can begin copying mailboxes several days before the final cutover.

DayExample
MondayInitial sync.
TuesdayError review.
WednesdayNew synchronizations.
ThursdayValidation.
FridayMX record change.
After the cutoverKeep the batch active temporarily until the transition is confirmed.

This is not real-time replication. The approximately daily synchronization means that IMAP should not be considered a real-time coexistence platform. The cutover still requires a defined window and a clear procedure. When to stop it. Once you have confirmed that new email is arriving in Microsoft 365 and that you no longer need to retrieve changes from the source, you can delete the batch.

Official reference: Microsoft – IMAP migration with PowerShell.

Excluding or including folders

It is not always necessary to migrate absolutely everything contained on the server. Exchange Online allows for the use of inclusion and exclusion parameters in specific IMAP batches.

Example

$CsvFile = "C:\Temp\IMAP-Wave01.csv"

New-MigrationBatch `
    -Name "IMAP-Wave01" `
    -SourceEndpoint "IMAP-Hosting" `
    -CSVData ([System.IO.File]::ReadAllBytes($CsvFile)) `
    -ExcludeFolders "Trash/*","Spam/*" `
    -AutoStart

Scenarios where exclusions might make sense. Junk, Spam, Trash, temporary folders, or clearly obsolete repositories. Do not apply general exclusions without verifying the actual folder names. A folder named Archive might be dispensable on one server but contain critical information on another. For this reason, the person conducting the pilot must review the actual folder tree. Official reference: Microsoft – New-MigrationBatch.

Useful Exchange Online PowerShell commands during migration

When managing a migration, it makes more sense to use Exchange-specific cmdlets rather than simply checking licenses.

Connecting

Install-Module ExchangeOnlineManagement -Scope CurrentUser

Connect-ExchangeOnline

Viewing endpoints

Get-MigrationEndpoint |
    Format-Table Identity,EndpointType,RemoteServer

Viewing batches

Get-MigrationBatch |
    Format-Table Identity,Status,TotalCount,SyncedCount

View users in a batch

Get-MigrationUser -BatchId "IMAP-Wave01" |
    Format-Table Identity,Status

Review a user with issues

Get-MigrationUserStatistics `
    -Identity "usuario@empresa.com" `
    -IncludeReport |
    Format-List Status,Error,SkippedItemCount,Report

Review skipped items

Get-MigrationUserStatistics `
    -Identity "usuario@empresa.com" `
    -IncludeSkippedItems |
    Select-Object -ExpandProperty SkippedItems |
    Format-List DateReceived,Subject

Delete the batch when synchronization is no longer needed

Remove-MigrationBatch -Identity "IMAP-Wave01"

These examples are for guidance only. Before executing them, you should verify permissions, names, the batch status, and potential operational consequences.

Monitoring: “Synced” does not mean everything is perfect

The Exchange Admin Center displays various batch statuses.

StatusGeneral interpretation
SyncingThe transfer is in progress.
SyncedThe initial synchronization is complete.
Synced with errorsThere is information that requires review.
FailedThe mailbox or process could not be completed successfully.
CompletedJob finished, depending on the batch type.

What to check, beyond the status. Errors, skipped items, last sync, volume, and user-defined checks. A batch can be slow without being broken. Microsoft explains that migration has a lower priority than certain critical Exchange Online functions, such as mail flow and connectivity. Therefore, periods of slowdown may be considered normal behavior. Do not base your diagnosis solely on the percentage.

When a user’s migration appears to be stalled, it is advisable to obtain: Get-MigrationUserStatistics, IncludeReport. Official reference: Microsoft – Troubleshoot IMAP mailbox migration.

Contacts: planning for them outside of IMAP

Personal contacts are not included in an IMAP migration. Where they might be located.

SourcePossible handling methods
Outlook PSTImport via Outlook/PST.
CSVImporting contacts.
WebmailExport (if permitted by the provider).
MobileDetermine whether they are local or synchronized contacts.
External applicationExport/API (depending on the product).

Not all contacts necessarily need to be migrated. There may be thousands of obsolete or duplicate contacts. If the address book has business value, it warrants a separate review.

Calendars: likely the most visible difference for the user

A user might assume that their calendar is part of “the email account,” but IMAP does not recognize it as such. What needs to be identified. Personal calendar, future events, recurring events, shared calendars, room calendars, and local calendars. Options. Depending on the source: PST, ICS, provider export, specialized tool, or manual recreation. Future events first. When it is not possible to migrate everything with complete fidelity, the priority is usually to ensure the user does not lose future meetings and appointments.

Sent Items: review before the pilot phase

Sent messages are typically part of the IMAP structure, provided the folder is correctly stored on the server—though this should not be assumed. Common issues. The email client might store sent messages in: a local folder, a PST file, or an IMAP folder with a different name. Quick check. Comparing the “Sent” folder in webmail with the one in Outlook allows for a quick determination of whether any local content exists.

Generic accounts and shared mailboxes

IMAP hosting providers often use full accounts for addresses such as: info@empresa.com ventas@empresa.com administracion@empresa.com with the password shared among several people. Exchange Online offers a different model. We can consider creating a Shared Mailbox and granting: Full Access, Send As, or Send on Behalf permissions depending on the requirements. Advantage. Each user employs their own identity, rather than sharing a generic password.

50 GB without a dedicated license. Microsoft currently allows a shared mailbox—without its own dedicated license—to hold up to 50 GB, subject to applicable terms. Exceeding this capacity, or utilizing features such as archiving, litigation hold, or other advanced functions, requires the appropriate licensing. Official reference: Microsoft – About shared mailboxes.

Google Workspace: do not limit it to just an IMAP migration

While Google Workspace exposes Gmail via IMAP, this does not necessarily mean that IMAP is the best migration path for a company moving away from Google. Microsoft offers a dedicated migration process. The Google Workspace-specific migration path can handle: email, calendars and contacts and Microsoft has continued to expand its specialized tools for this source environment.

ElementGeneric IMAPGoogle Workspace Migration
EmailYes.Yes.
ContactsNo.Yes, though with documented limitations.
CalendarNo.Yes, though with documented limitations.
RulesNo.Specific support is available depending on the chosen migration path.

In what cases might IMAP still be relevant?

In very specific scenarios or as a technical alternative; however, it should be weighed against the Google Workspace-specific migration path before making a decision. Official reference: Microsoft – Automated Google Workspace migration.

Not sure if your source environment should be migrated via IMAP?

The available protocol does not always dictate the best tool. We can review your provider and the data you need to retain to compare IMAP against other migration paths before starting the project.

Review my migration scenario

Domain and DNS: preparing for the cutover

An email migration involves two distinct workflows: migration of historical data and redirection of new email. IMAP batches handle the former, while DNS determines the latter. Key records.

RecordFunction
TXTDomain verification.
MXInbound delivery.
AutodiscoverExchange Online service discovery.
SPFAuthorized sending sources.
DKIMSigning of outbound email.
DMARCAlignment, policy, and reporting.

MX records: when to change them

The MX record should be updated once Exchange Online is ready to serve as the production system. Before the change. We should verify: users, licenses, aliases, Exchange Online, batches, mail flow, and critical applications. The MX record does not copy data. Changing the MX record does not move any historical messages; it simply tells sending servers where to deliver new email. Do not cancel the existing hosting immediately.

For a controlled period, it may be advisable to maintain access to the previous system for: incremental synchronizations, validations, and exceptions. Official reference: Microsoft – Connect a domain using DNS records.

SPF during an IMAP migration

The SPF record must account for all systems that are still legitimately sending email on behalf of your domain. A single SPF record. You should not publish one SPF record for Microsoft and a separate one for your hosting provider. There must be a single record that correctly combines all the necessary sources. During the coexistence phase. It may be necessary to temporarily authorize: Microsoft 365, a legacy IMAP provider, CRM, ERP, web services, or a marketing platform.

After. Once a legacy service is decommissioned, you should remove its corresponding source from your SPF record. Official reference: Microsoft – Configure SPF.

DKIM for Microsoft 365

Microsoft recommends using DKIM in conjunction with SPF and DMARC to secure authentication for custom domains. Two CNAME records per domain. Microsoft uses two DKIM selectors. The specific values ​​must be retrieved from your tenant. Important as of 2025. Microsoft has introduced a new DKIM CNAME format for new custom domains. For this reason, it is even more critical not to copy static examples found online..

Obtain the correct values.

You can use the Microsoft Defender portal or Exchange Online PowerShell.

Get-DkimSigningConfig `
    -Identity "empresa.com" |
    Format-List Name,Enabled,Status,Selector1CNAME,Selector2CNAME

Official reference: Microsoft – Configure DKIM.

DMARC: managing the transition without blocking legitimate email

DMARC uses SPF/DKIM authentication and alignment with the sender’s visible domain.

PolicyGeneral meaning
p=noneMonitoring.
p=quarantineRequests restrictive handling.
p=rejectRequests rejection.

Migration is a poor time to discover forgotten senders. Before tightening DMARC, we must identify: ERP, CRM, newsletters, web, ticketing systems, SaaS applications, and any other sender. Reasonable sequence. inventory → authenticate → observe → correct → tighten. Official reference: Microsoft – Configure DMARC.

Autodiscover and Outlook

After the cutover, the user stops connecting to the previous IMAP server and begins working with Exchange Online. The old profile may contain: IMAP server, SMTP server, ports, authentication, PST files, and historical configuration. New profile. In some cases, it may be preferable to create a clean Outlook profile. The decision depends on: Outlook version, profile status, existing PST files, and deployment procedure.

Cloud migration and endpoint configuration are distinct scopes. Mailbox migration can be handled centrally, whereas individual device configuration must be explicitly defined on an as-needed basis.

Applications, websites, and printers that send email

A company almost never consists solely of users sending emails.

SystemExample
ERPSending invoices.
CRMNotifications and communications.
WebContact form.
ScannerScan-to-email.
MonitoringAlerts.
Custom applicationSMTP/API.

These dependencies are not migrated via IMAP. We must determine how they will send emails after the change. Do not reuse old configurations without first analyzing them. The Microsoft 365 SMTP server, port, authentication, and security settings may differ. Furthermore, Microsoft is continuously evolving its authentication methods, so it is important to use the appropriate option for each type of application.

Native Microsoft tools vs. specialized third-party tools

The native tool is perfectly suitable for many projects, though not necessarily for all of them.

OptionWhen it might be a good fit
Microsoft IMAP MigrationEmail and folders from a relatively standard IMAP server.
BitTitan MigrationWizProjects requiring an additional layer of reporting, mapping, or operational control.
CodeTwo Office 365 MigrationEmail migrations originating from an IMAP source with specific execution requirements.
Other specialized toolsWhen the source platform offers a more comprehensive connector than IMAP.
PST ImportHistorical data not stored on the server.

What to compare. Cost, authentication, limits, deltas, filters, reporting, mapping, throttling, support, and fidelity. BitTitan. MigrationWiz currently provides a specific guide for IMAP → Microsoft 365. The vendor also explains that their platform is a migration tool, not a live synchronization solution; therefore, it is essential to understand exactly how project passes function. CodeTwo. CodeTwo Office 365 Migration currently supports IMAP servers as a source, allowing for the configuration of connections, throttling, and migration jobs.

The tool does not resolve the inherent limitations of the IMAP protocol. If the source only exposes email via IMAP, a third-party platform cannot automatically “invent” calendars that are not available through that interface. This is why analyzing the source environment is more important than the specific product brand. References:

Recommended phases for an IMAP migration to Microsoft 365

PhasePurpose
1. DiscoveryIdentifying users, mailboxes, and the source environment.
2. ScopeDefining what will be migrated and what will not.
3. Target designUsers, shared mailboxes, and licenses.
4. DNS planningPreparing the domain and mail flow.
5. EndpointValidating the IMAP connection.
6. PilotMeasure actual results.
7. PremigrationCopy the bulk of the email.
8. Error remediationCorrect credentials, folders, and items.
9. CutoverSwitch the email flow.
10. Incremental syncCollect pending changes.
11. ValidationConfirm results.
12. DecommissionRetire the previous service.

What the pilot phase should look like

A good pilot should uncover issues before the entire company encounters them.

ProfileWhat we validate
Standard mailboxGeneral process.
Large mailboxPerformance.
Large volume of messagesNumber of items.
Many foldersIMAP structure.
Special foldersSent, Trash, Junk.
Local PSTData outside of IMAP.
Generic accountConversion to a Shared Mailbox.
Mobile userPost-cutover experience.

The pilot phase should provide us with metrics. By the end, we should know: Approximate GB/hour, messages/hour, supported concurrency, typical errors, and manual tasks.

Cutover: moving production to Exchange Online

Once the majority of the content has been synchronized, it is time to switch the mail flow.

SequenceAction
1Review batches.
2Confirm users and licenses.
3Validate aliases and shared mailboxes.
4Test Exchange Online.
5Confirm external senders.
6Update MX records.
7Update SPF records.
8Validate DKIM.
9Review DMARC.
10Test input/output.
11Review applications.
12Maintain incremental sync temporarily.

TTL. Reducing the TTL for specific records beforehand can help shorten the DNS transition, although it never makes propagation instantaneous.

Migration doesn’t end when the batch status is “Synced”

1. Quantitative validation. Review: Users, volume, folders, items, and errors. 2. Functional validation.

TestResult
LoginCorrect.
Outlook on the webCorrect.
External → userReceived.
User → externalDelivered.
Internal → internalCorrect.
AliasCorrect.
Shared MailboxCorrect permissions.

3. Historical data. Check samples of: recent messages, older messages, Inbox, Sent, personal folders, and attachments. 4. Skipped items. Review the skipped items and determine whether: they are acceptable, can be recovered via another method, or should be documented as an exception. 5. DNS. Check: MX, SPF, DKIM, and DMARC. 6. Applications. Validate systems that use email.

What changes for users

For someone accustomed to an IMAP mailbox, the visible change can be significant.

BeforehandAfterwards
IMAPExchange Online.
Independent SMTP serverMicrosoft sending service (based on configuration)
Local calendarExchange calendar (if migrated/recreated)
Local contactsExchange contacts (once added)
Generic account shared via passwordShared mailbox with permissions (where applicable)
Limited access to the providerOutlook, web, and mobile access via Microsoft 365.

Minimum necessary communication

The user should know: when the change will take place, how to log in, what happens with Outlook, whether any action is required on their part, and where to seek assistance.

An email migration shouldn’t leave any surprises for Monday morning.

Beyond just moving data, it’s important to prepare for the cutover, access changes, and validation, ensuring every user knows what to expect in Microsoft 365.

Preparing my IMAP → Microsoft 365 project.

How long an IMAP migration takes

There is no standard duration per mailbox.

FactorImpact
GBVolume to be transferred.
ItemsNumber of operations.
Source serverSource capacity.
Connection limitsConcurrency.
Microsoft throttlingService availability.
Large itemsExceptions.
FoldersComplexity.
PSTAdditional processes.
Contacts/CalendarAdditional processes.

Example. Two companies might both have 50 users. The first has 50 mailboxes of 3 GB each on a fast server. The second has 50 mailboxes of 25 GB each, hundreds of thousands of messages, and a hosting environment that allows only a limited number of connections. These are not equivalent projects. The best estimate comes from a pilot. By testing a few representative mailboxes, we can better calculate: batch sizes, concurrency, dates, and a buffer for remediation.

Common errors during an IMAP migration to Microsoft 365

ErrorConsequenceBetter approach
Assuming IMAP migrates everythingContacts and calendar are missing.Define the actual scope.
Not reviewing PST filesHistorical data is missing.Inventory local data.
Not counting messagesDiscovering the item limit too late.Assessment.
Not checking for large messagesOmitted items.Identify them beforehand.
Not reviewing the “Sent” folderSent mail is missing.Compare webmail with the email client.
Not testing special foldersUnexpected structure.Pilot.
Folders with problematic namesThey do not migrate correctly.Detect and correct.
Not knowing the credentialsThe migration process cannot access the source.Resolve authentication issues beforehand.
Keeping the password CSV file indefinitelySecurity risk.Monitor and remove it afterward.
Increasing concurrency indiscriminatelyServer lockups.Measure.
Using IMAP for Google Workspace without comparing alternativesUnnecessary loss of data fidelity.Evaluate Google-specific migration methods.
Using IMAP for Exchange when unnecessaryLoss of Exchange-specific elements.Evaluate native Exchange migration paths.
Changing MX too earlyEmail arrives before users are preparedControlled cutover.
Confusing MX record updates with the migration processHistorical data not migrated.Separate the two processes.
Publishing two SPF recordsIncorrect configuration.Consolidate sources.
Copying DKIM settings from an exampleIncorrect values.Retrieve them from the tenant.
Applying DMARC “reject” policy without prior analysisLegitimate email is affected.Phased deployment.
Overlooking SMTP applicationsERP or web applications stop sending emailsCreate an inventory of senders.
Canceling the hosting service immediatelyLoss of the validation window.Transition period.
Confirm “Synced” statusNo errors detected.Functional validation.

Checklist before migrating via IMAP to Microsoft 365

AreaCheck
ProviderIdentified.
IMAP serverIdentified.
PortConfirmed.
EncryptionConfirmed.
CredentialsAvailable.
UsersInventoried.
AliasesInventoried.
Generic mailboxesIdentified.
SizesReviewed.
Number of itemsReviewed.
Messages >35 MBIdentified.
FoldersReviewed.
Sent ItemsVerified.
ContactsScope determined.
CalendarsScope determined.
PSTIdentified.
SMTP applicationsInventoried.
TenantPrepared.
DomainVerified.
Target usersCreated.
LicencesAssigned.
MailboxesProvisioned.
CSVPrepared.
EndpointTested.
Excluded foldersDefined.
PilotCompleted.
ConcurrencyAdjusted.
MXChange prepared.
SPFPrepared.
DKIMPrepared.
DMARCReviewed.
AutodiscoverReviewed.
OutlookProcedure defined.
UsersCommunicated.
ValidationCriteria prepared.
Previous providerDecommissioning date defined.

Frequently asked questions about IMAP to Microsoft 365 migration

Does IMAP migrate contacts and calendars to Microsoft 365?

The IMAP method focuses on server-side email. Contacts and calendars must be inventoried and migrated using a procedure compatible with their location and format. It is advisable to confirm this scope before beginning, as a test that only checks messages might overlook information the user has stored in another application or on their local device.

What happens to email stored exclusively on a computer?

Such data cannot be assumed to be included in a copy taken from an IMAP server. First, you must locate where it is stored, verify its format, and agree on a transfer procedure. The user should be involved in reviewing historical folders to distinguish between items already on the server and those that exist only in a local copy.

Can the copying process begin before the domain is switched?

Depending on the tool and the design used, the preparation phase can separate the initial transfer from the actual switchover of email reception. It must be clearly defined which environment remains the active workspace and how subsequent messages will be collected. The switchover should only take place once the destination environment is ready and testing is complete—not simply because an initial copy has finished.

How are messages that failed to copy reviewed?

You should use the generated reports and error identifiers to pinpoint the cause, the affected folder, and the user involved. There may be content that falls outside the scope, source-side restrictions, or items that require a different handling approach. Any discrepancies should be documented and validated with the person in charge; simply repeating the entire migration process without a proper diagnosis may result in duplicates without actually resolving the underlying issue.

Final recommendations: IMAP works very well when you know exactly what you are migrating

A IMAP migration to Microsoft 365 This can be a simple and effective way to move email from hosting providers and compatible servers to Exchange Online. However, its simplicity hinges on a correct understanding of the scope. IMAP allows for the copying of messages and folders; it should not be presented as a complete migration of every feature or capability that a user associates with their email account.

Contacts, calendars, tasks, rules, signatures, delegations, and local settings require an independent strategy. Before beginning, we must also understand the source server. Credentials, connection limits, folder names, and throttling can have a greater impact on the migration timeline than the bandwidth contracted by the organization. Microsoft’s native tool allows for work to be organized via endpoints and batches, enabling initial data loads prior to the cutover, as well as incremental synchronizations—occurring approximately every 24 hours—while the batch remains active.

This significantly reduces the volume of data remaining to be migrated during the final cutover window. We must also be aware of current limitations: Microsoft specifies a maximum of 500,000 items per mailbox and a maximum message size of 35 MB for IMAP migrations. These parameters, along with the number of folders and the behavior of the source server, should be evaluated during the assessment phase.

Furthermore, there are scenarios where IMAP should not be the primary choice. Google Workspace, for instance, has a dedicated path provided by Microsoft that can migrate email, calendar, and contact data. Exchange Server includes its own native mechanisms that offer higher fidelity. Additionally, a migration between Microsoft 365 tenants should be handled as a cross-tenant project. If IMAP is selected, the procedure should follow a clear sequence: discovery → tenant preparation → endpoint setup → pilot → pre-migration → error remediation → cutover → incremental synchronization → validation → decommissioning of the source environment.

The MX record change should only take place once Exchange Online is fully prepared. SPF records must account for all legitimate sources, DKIM must be configured using the tenant’s actual values, and DMARC policies should be evolved in a controlled manner following the verification of authentication. Finally, a project should not be considered complete simply because the dashboard indicates Synced. The migration is complete when users can successfully send and receive emails via Exchange Online, historical data is accessible, any exceptions are documented, applications continue to send mail, and the previous provider can be decommissioned without any ongoing dependency..

Do you need to migrate IMAP email to Microsoft 365?

In Kloudeal We can help you analyze and execute a migration from cPanel, Plesk, Zimbra, Dovecot, Courier, Kerio, or other IMAP-compatible email services to Exchange Online. We can assist with mailbox inventory, IMAP endpoints, migration batches, Exchange Online setup, user accounts, licenses, aliases, shared mailboxes, PST files, contacts, calendars, MX/SPF/DKIM/DMARC records, SMTP-based applications, pilot phases, cutover, and post-migration validation. Please let us know your current provider, the approximate number of accounts, the volume of email, and your target date; we will then determine what additional information is required to define the project.

Request an assessment for an IMAP to Microsoft 365 migration

Recommended official documentation

IMAP migration.

Migration batches and PowerShell.

Performance.

Exchange Online.

Google Workspace.

DNS and email authentication.