Introduction to the SharePoint Migration Tool

SharePoint Migration Tool, also known as SPMT enables you to migrate documents to Office 365 (SharePoint or to OneDrive) from these two sources:

  1. SharePoint Server 2010 & 2013
  2. On-premises file shares

The tool is not able to migrate documents between two sites in SharePoint Online. For this use case, use the standard “Move to function”, available in the document library’s toolbar.

When it comes to SharePoint Server the tool will allow you to migrate these different types of items:

  • Document lists and libraries
  • SharePoint list templates (see supported list here)
  • “Out of the Box” SharePoint sites – sites that do not use any coding or 3rd party tools
  • Navigation and icons
  • Site description
  • SharePoint web parts (see supported list here)
  • Pages, including any pages in site asset library
  • Managed metadata, including content types and term stores. Migration of global term store requires Global Tenant Admin permissions.

For more information see: Overview of the SharePoint Migration Tool.

Some facts about the tool

  • In the destination document library, the tool creates a folder hierarchy, representing the folder hierarchy in the source location.
  • Migrated documents maintain these metadata from the source location:
    • Created date
    • Last modified date
    • Created by
    • Modified by
  • Options when migrating documents are:
    • In the case that the tool is used to Migrate data from SharePoint 2013, it is possible to migrate all versions of documents.
    • To maintain the permissions that were set in the source location. It is also possible to use a mapping table for usernames.
    • It is possible to only migrate documents that are newer than a specific date (can be applied on both creation date and last modified date).

The tool has a graphical user interface, but it is also possible to use PowerShell to run migration jobs. For more information see: Migrate to SharePoint Online using PowerShell.