My Sites to OneDrive migration guide

This guide will help you prepare to migrate from My Sites to OneDrive in Microsoft 365.

Most migrations include these phases: planning, assessing and remediating, preparing the target environment, migrating and onboarding users.

Migration process

Migration planning Assess and remediate Prepare your OneDrive environment Migrate User onboarding
What content goes where

Understanding permissions vs. sharing

What to expect before and after

Migration and network performance considerations

Change management and communications

Assess key areas

Remediate issues
Pre-provision Microsoft 365 and users Migration steps

Configure SharePoint hybrid

Migration service providers
Send regular emails to users

Provide training

Tell users how they're affected

Provide documentation for making the switch

Migration planning

Before you begin migration, assess your current source environment. What you discover will influence your overall strategy and timing, including:

  • The mapping of content from your source My Sites to the destination OneDrive.
  • The amount of content to migrate. Determine what content is redundant, out of date, or still relevant.
  • Set permissions so IT can read/write from the source to the destination.

We strongly recommend that you consider setting up a hybrid environment. To learn more, see SharePoint server hybrid configuration roadmaps.

What migrates?

When you migrate to OneDrive by using the SharePoint Migration Tool, you'll migrate content from your My Sites document library into OneDrive.

Assess and remediate your content

Before you start your migration, it's important that you analyze your current environment. Only you know your data and how and who uses it. Think about how and what My Sites features you use in production.

An assessment can begin by working with your users in two main areas:

  • Identify older content.
  • Determine if content is obsolete or redundant and can be deleted.

Using the SharePoint Migration Assessment Tool

The SharePoint Migration Assessment Tool (SMAT) is a simple command-line tool that scans the contents of your SharePoint Server 2010, 2013, or 2016 farm to help identify any issues before you migrate your content.

After the scan is complete, SMAT generates summary and detailed reports that identify areas that could affect your migration.

SMAT includes the SharePoint Migration Identity Management Tool, which does identity mapping by scanning SharePoint, Active Directory, and Microsoft Entra ID.

SMAT scans many areas. The following table shows common areas of concern when migrating from My Sites. Your environment isn't affected when SMAT performs its scan.

Scan Description
File versions The more versions of a file you have, the longer it will take to migrate.
Note: By default, versioning is enabled for all lists and libraries on the target platform. In the destination SharePoint site, there's no limit when versioning is enabled.

See Migration assessment scan: File versions
Large lists Lists of more than 20,000 items may cause migration issues, making it more difficult to predict how long migrating these sites will take. List data will still migrate, but the larger the list the more unpredictable the migration process. Extremely large lists can cause extended migration.

See Migration assessment scan: Large lists
Long OneDrive URLs Content with long URLs that exceed a limit will be skipped. They won't migrate.

See Migration assessment scan: Long OneDrive URLs
Checked-out files Only checked-in content will be migrated. Make sure that users check in their files before migration to avoid data loss.

See Migration assessment scan: Checked-out files
Large Excel files If you try to open a file larger than 10 MB from OneDrive (online), you'll be prompted you to open the file in the Excel client.

See Migration assessment scan: Large Excel files
Large list views In your My Site, you can configure list-view throttling so the throttle on views is lifted during certain hours of the day. In OneDrive, the limit is in place around the clock. While your lists and data will still be migrated, some of your list views may be throttled.

See Migration assessment scan: Large list views
Browser file handling SharePoint Server allows settings that range from "strict" to "permissive." But in SharePoint and OneDrive in Microsoft 365, the "strict" setting is enforced and can't be modified. All data will be migrated, but the behavior with the HTM and HTML files will change from opening within the browser to prompting the user to download.

See Migration assessment scan: Browser file handling
InfoPath InfoPath lets developers build custom forms to accept user input in various locations throughout SharePoint. Note that some features of custom InfoPath forms won't be migrated.

See Migration assessment scan: InfoPath

Prepare your OneDrive environment

Before you migrate your My Sites content, you must pre-provision your users in OneDrive:

  • Prepare to provision users through directory synchronization to Microsoft 365. Provisioning users with directory synchronization requires more planning and preparation than simply managing your work or school account directly in Microsoft 365. These additions ensure that your on-premises Active Directory synchronizes properly to Microsoft Entra ID.

  • Pre-provision OneDrive for users in your organization. By default, the first time that a user browses to their OneDrive, it's automatically provisioned for them. In some cases, such as when your organization plans to migrate from your on-premises My Sites, you'll want your users' OneDrive locations ready beforehand (pre-provisioned).

  • Configure Microsoft 365 for SharePoint hybrid (optional). With SharePoint Server hybrid, productivity services in SharePoint in Microsoft 365 can be integrated with on-premises SharePoint Server to provide unified functionality and access to data. For enterprises that want to gradually move their existing on-premises SharePoint Server services to the cloud, SharePoint Server hybrid provides a staged migration path by extending high-impact SharePoint Server workloads to SharePoint.

A SharePoint Server hybrid environment enables trusted communication between SharePoint in Microsoft 365 and SharePoint Server. After you establish this trust framework, you can configure integrated functionality between services and features such as Search, Follow, and user profiles. You need to set up basic integration between Microsoft 365 for enterprises and SharePoint Server before you can configure a hybrid environment.


Use the SharePoint Migration Tool to easily migrate your existing My Sites to OneDrive.

  1. Install and launch the SharePoint Migration Tool. You'll select the bulk migration option using the .json or .csv file that you created. For details, see Using the SharePoint Migration Tool.

  2. Create a mapping file. Create a mapping file with source and target paths and save it as .csv. For details, see How to format your JSON or CSV for data content migration.

Migration best practices

The following information describes a typical migration process that follows Microsoft best-practices guidance.

  1. Select a small set of users for a pilot migration. The goals of the pilot are to validate the process, including performance and user communication, and to get a sample of user feedback.

  2. Run the pilot migration. Use an incremental migration method that runs in the background with no user impact, followed by a cutover event in which users' on-premises My Sites accounts are disabled. Direct users to the target OneDrive environment. This method is preferred, as it reduces user impact.

  3. Assess the data from the pilot migration to determine the rest of your migration schedule, and make any changes. For example, you might update your user communication template to address questions you received from pilot users.

  4. Do the rest of the migration. Use an incremental migration method, just like the pilot. We recommend a single cutover event for all users to switch to OneDrive and then disable their My Sites accounts. This approach helps eliminate any confusion resulting from users having to collaborate by using both My Sites and OneDrive at the same time.

User adoption

Develop a plan to prepare your users for the upcoming change. Consider these factors:

  • Evangelize the move: Emphasize the benefits, collaborative capabilities, and reasons for the move.

  • End-user training: Provide training to your users on OneDrive features.

  • Train your helpdesk: Before the cutover, train your helpdesk in key features and common user questions.

  • Downtime: Prepare for any possible downtime that the migration may involve.

  • Communicate: Develop a plan for sending communications to your users. Provide clear statements about timing, expectations, and impact to individuals.

  • Be public about the timeline: Publish the migration timeline with details about user impacts. Include any user calls to action.

  • Reassure your users: Assure users that content already in OneDrive is safe and won't be overwritten.

  • Opting out: Tell users whether they can opt out of the migration process.

  • Microsoft 365 Adoption Guide: Outlines methodology and resources for implementing proven adoption success factors.
  • OneDrive Adoption: This Resource Center serves as your one stop shop for all adoption and change management-related content.

Make the switch!

The following articles can help your users "make the switch" from My Sites to OneDrive. They show how to do common tasks in OneDrive.

Advanced support

Your enterprise may have specific business needs that require you to use third-party services or applications to help with your migration to Microsoft 365. Explore the professional services and applications available from partners in the Microsoft Partner Center.