Overview of the SharePoint Migration Tool (SPMT)

The SharePoint Migration Tool (SPMT) is a free and easy to use migration solution to help you migrate content from on-premises SharePoint sites to Microsoft 365.

Migrate your SharePoint Server sites and content to take advantage of the latest collaboration, intelligence, and security solutions in Microsoft 365. The modern experience features in Microsoft SharePoint are designed to be compelling, flexible, and performant.

SPMT supports migration to SharePoint, OneDrive, and Teams from:

  • SharePoint Server 2010, 2013, and 2016
  • SharePoint Foundation 2010 and 2013

For a complete description of features, see What does SPMT support?

All SPMT functionality is also supported in PowerShell, if you prefer to use that method. See Migrate to SharePoint using PowerShell.

Supported authentication methods

SPMT supports NTLM, Kerberos, Forms, ADFS, multifactor authentication, SAML-based claims, and Client certificate authentication.

Important

If the on-premises server is configured to support multiple authentication providers, including Windows authentication, then Windows authentication will not be supported. If this describes your environment, use other authentication methods instead of Windows authentication.

Planning and assessment

Planning is the key to successful data migration. The SharePoint Migration Assessment Tool (SMAT) is a simple command-line tool that scans your SharePoint Server 2013 farm to help identify potential issues with the data that you plan to migrate to SharePoint in Microsoft 365. The results report points to articles to help fix any issues that are discovered. The tool runs in the background and doesn't affect your production environment.

To download the tool, go to SharePoint Migration Assessment Tool (SMAT)

Note

The SharePoint Migration Tool isn't available for users of Office 365 operated by 21Vianet in China. It's also not available for users of Microsoft 365 with the German cloud that use the data trustee German Telekom. It is supported for users in Germany whose data location isn't in the German datacenter.

Get started

To get started:

Make sure that you have:

  • Access to the destination: You must either be a global admin or OneDrive/SharePoint admin.
  • Access to the source: SharePoint credentials that have read access to the SharePoint Server content you plan to migrate.
  • Prerequisites installed: Make sure you have the necessary prerequisites installed.

Step 1: Install SPMT

Step 2: Create a migration task

Step 3: Monitor and report

What does SPMT support?

How the SharePoint Migration Tool works

How to use the SharePoint Migration Tool

How to format your JSON or CSV for data content migration

Create a user-mapping file for data content migration

SharePoint and OneDrive migration speed

SharePoint provided Azure containers and queues for SharePoint Migration API