Kick start the new year and your cloud migration with new SharePoint Migration Tool improvements

Published Jan 07 2019 07:30 AM 19.8K Views

We’re excited to announce new improvements to the SharePoint Migration Tool for the month of January.


Designed to be used for migrations ranging from the smallest set of files to a large scale enterprise migration, the SharePoint Migration Tool will let you bring your information to the cloud and take advantage of the latest collaboration, intelligence, and security solutions with Office 365.


Improvements this month include:


A new, updated UI aligned with the Office 365 user experience

This release of the SharePoint Migration Tool includes improvements to the user interface with a new, simplified control service more aligned to the visual themes of SharePoint Online.





Ability to start new migrations without having to restart the SharePoint Migration Tool

Now in this release of the SharePoint Migration Tool you can start new migrations without having to restart the migration tool.





Improved interaction flow including simplified setting review experience

More easily access and view the settings needed to support your migration scenario with a new simplified interaction flow and review experience.





About the SharePoint Migration Tool

The SharePoint Migration Tool is designed to simplify your journey to the cloud through a free, simple, and fast solution to migrate content from on-premises SharePoint sites and file shares to SharePoint or OneDrive in Office 365.  The SharePoint Migration Tool allows you to accelerate your journey to Office 365 overcoming obstacles typically associated with migration projects.  With the SharePoint Migration Tool you can evaluate and address the information that matters the most to your organization, the Libraries, and now Lists that form the foundation of the SharePoint experience.  Using the SharePoint Migration Tool you can start your migration today and take advantage of the full suite of features and security capabilities that Office 365 offers.


Keep reading to learn more about the SharePoint Migration Tool or download the latest version now at


Getting Started

You can download the SharePoint Migration Tool at  Through this version of the SharePoint Migration Tool you’ll have available to you the innovation we’re delivering to help you bring your information to the cloud and take advantage of the latest collaboration, intelligence, and security solutions with Office 365.


What’s next…

Through continued innovation across migration scenarios we’ll be adding more capabilities over time to the SharePoint Migration Tool, including support for more SharePoint versions, site structure migrations, and more.  Subscribe here to stay up to date on future announcements for SharePoint and Office 365.


Wrapping Up…

Whether you’re looking to migrate from file shares on-premises to SharePoint or OneDrive or from on-premises versions of SharePoint, the SharePoint Migration Tool is designed to support the smallest of migrations to large scale migrations with support for bulk scenarios.


Learn more about migrating to Office 365 at


Learn more about the SharePoint Migration Tool at


Prepare your environment for migration using the SharePoint Migration Assessment Tool by learning more at


New Contributor

I cannot connect my on-premises environment with the tool. 

Does this tool supports SharePoint Onpremises 2016 as well?

Trusted Contributor

@mehak narmeen Currently the SharePoint Migration Tool supports SharePoint Server 2013 as a source location for migration. 


"The SharePoint Migration Tool lets you select from two sources from which to migrate your data: from an on-premises SharePoint Server 2013 site or from a local file share or network path."


There are some further details here: How to use the SharePoint Migration Tool


This blog mentions "support for more SharePoint versions" is upcoming, so look out for enhancements in this regards later in the year. 


@mehak narmean The SharePoint Migration Tool (SPMT) supports SharePoint Server 2013 sites, lists, etc.  We're working on supporting additional versions.  In addition you can migrate file shares, e.g. shared and local content using SPMT.

Regular Contributor

This is a useful tool for simple migrations without complex permissions involved. One thing to keep in mind is that any network file shares with unique permissions may require a higher level of admin access for the user who is doing the migration, to migrate them. We hit that issue when we tried to migrate an NFS and discovered that there were folders with special permissions that we could not see (or migrate). 

Occasional Contributor

Is there a reason that you cannot use this tool to copy from site collection to another site collection to create a new site collection in SPO?

Senior Member



We have started using the tool to migrate documents from file shares to folks OneDrive.  Some of our users have had some files that are basically .doc or .docx that were moved into OneDrive, but have ~$ prefix the name.  These files that are working file on the file share are not opening now in OneDrive.  The documents that have this prefix seem to be at random.  I thought had first it could have been a file path length issue or a character in the file name issue, but we have consulted the employees and that is not the case.  If anyone else has run into this issue or can share some documentation about why it is doing this please let us know.  We want this process to go as smoothly as possible for our users.


Trusted Contributor

Andre @ NL Salomons Don't think there are any technical reasons for it, just seemingly not a priority, you can vote for this here, on this UserVoice suggestion though -


Support SharePoint Online to SharePoint Online Migrations in the SharePoint Migration Tool

Occasional Contributor

The subscribe link above it not working for me? Each time I click it all it loads is a page of XML?? I have tried in Chrome and in Edge and the same result.




Occasional Visitor

@Amy Coleman The files with $-prefixes I believe are restored/temporary files used by Word (If the application crashes/freezes and is restarted with unsaved changes), there should be corresponding files without the $-prefix, or you can open the $-files locally via the old fileshare, and save them without special characters in the filename.

Occasional Visitor
Can you target a folder within the Sharepoint site? Its strange that the folder selected is not included in the migration, only the subfolders.
Version history
Last update:
‎Jan 08 2019 01:24 PM
Updated by: