Overview: Migrate your file shares to Microsoft 365

Migrating your on-premises file share content to Microsoft 365 lets you collaborate with innovative Office apps, intelligent cloud services, world-class security, and the rich features offered in Microsoft SharePoint, Teams, and OneDrive. Migration Manager helps you get there.

With the ability to set up multiple servers as "agents", Migration Manager lets you scale your migration project as much as you need. Located in the modern SharePoint Admin Center, Migration Manager guides you through the setup of your agents and the creation of your tasks. You can specify global or task level settings, view all-up task progress, and download aggregated summary and task-level reports. Migration Manager also provides advanced features such as grouping agents to optimize performance, conduct pre-scans, and implement file exclusion metrics.

How does it work?

Set up migration agents

  • Setup migration agents. Download and install a lightweight agent on each computer or virtual machine you want to connect to Migration Manager. The agent runs as a service and authenticates to both your Microsoft 365 destination and your on-premises source.

  • Create tasks & migrate. Create a task by entering the URL of the network file share that you want to migrate (your source) and the URL of the SharePoint site where you are migrating your content (your destination), or upload a CSV file for multiple user migrations. Your tasks will be automatically assigned to the next available agent in the assigned agent group.

  • Monitor and report. Monitor progress across all agents, download summaries of migration jobs, and download detailed data on each individual migration.

File size migration limit

We support files up to 250 GB in size for file share to Microsoft 365 migrations.

Get started

Go to the Migration center in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.

Make sure that you have:

  • Access to the destination: You must either be a global admin or OneDrive/SharePoint admin to the Microsoft 365 tenant where you want to migrate your content.

  • Access to the source: Windows credentials that have read access to any of the network file shares you plan to migrate.

  • SMB 2.0: The server hosting the data (your source) must support SMB 2.0 or higher

  • Prerequisites and endpoints: Make sure your computer or VM has the necessary prerequisites installed and have the required endpoints open: See here for the List of prerequisites and required endpoints.

  • File size: File share migration supports migrating individual files of up to 250 GB.


When using Migration Manager to migrate content to non-English SharePoint sites, make sure the site title does not include non-English characters.

User Onboarding

Develop a plan to prepare your users for the upcoming change. Consideration factors to include in your plan:

  • Evangelize the move. Underscore the benefits, the collaborative capabilities, and the reasons for making the move.
  • End user training. Provide training to your users on the features in OneDrive.
  • Train your helpdesk. Before the cut-over event, train your helpdesk in key features and common user questions.
  • Prepare for any possible downtime. Plan for possible downtime during the migration.

Develop a plan for sending communications to your user base, providing clear statements of timing, and expectations and impact to the individual, including:

  • The migration timeline and how it will impact them. Include any user calls to action.
  • Assure them that if they already have content in OneDrive, their content is safe and won't be overwritten.
  • Let them know whether individuals can opt out of the migration process.

How to set up agents in Migration Manager
Migration Manager settings
How to format your CSV or JSON file for bulk upload into the Migration Manager
Migration Manager FAQs