Step 1: Install the SharePoint Migration Tool (SPMT)

Download and install

Download and install SPMT using one of the links listed below.

Public preview First release General Availability
Install here Install here Install here

Before you begin

Before you begin using SPMT, review the required permissions, prerequisites, and endpoints.

What Description
Permissions required Global or SharePoint Admin. To migrate at the organization-level, you must sign in as a Global or SharePoint admin in Microsoft 365.
Site Admin. To migrate at the site collection level, you must be a site admin for that site collection. Learn more: Understanding permissions when using the SharePoint Migration Tool
Prerequisites and Endpoints Review the SPMT system prerequisites and endpoints
SPMT Settings Review SPMT settings to understand how settings can impact your migration
Understanding Custom scripts

Allow or prevent Custom Script (NoScript)

In Microsoft 365, tenants can control if users can run custom script on personal sites and self-service created sites.

During migration, some web parts require this setting set to allow. Otherwise, the web part will not be migrated.

At least 24 hours before you start migration, do the following:

  1. Go to the Settings page of the new SharePoint admin center, and sign in with an account that has admin permissions for your organization.

    Note

    If you have Office 365 Germany, sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.
    If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.

  2. At the bottom of the page, select classic settings page.

  3. Under Custom Script, select:

    Allow users to run custom script on personal sites
    Allow users to run customer script on self-service created sites

    Leave these settings in place for the duration of your migration.

    Note

    Changes to this setting might take up to 24 hours to take effect.

    For more info, see, Allow or prevent custom script.

Next step

Step 2: Create a migration task

Note

Currently, the SharePoint Migration Tool is not available for users of Office 365 operated by 21Vianet in China.

It is also not available for users of Microsoft 365 with the German cloud with the data trustee, German Telekom. However, we do support it for users in Germany whose data location is not in the German datacenter.

Introducing the SharePoint Migration Tool

How the SharePoint Migration Tool works

How to format your JSON or CSV file for data content migration

Create a user mapping file for data content migration

SharePoint and OneDrive migration speed

SharePoint Migration Tool Feedback and Support Forum