

Microsoft’s free SharePoint Migration Tool includes Teams functionality—but is it capable of helping you with your Microsoft Teams migration? To answer that question, we explore some of the key differences between the SPMT and ShareGate Desktop’s Teams migration tool.
Content is at the center of collaboration in Microsoft 365—whether that collaboration takes place in SharePoint, OneDrive, or, increasingly, Microsoft Teams. And with the rise in Teams usage, it only makes sense that we also want our Teams data to transition seamlessly with us.
Since the ShareGate team is well-known for ShareGate Desktop, our SharePoint migration tool—and since Teams is part of the same Microsoft 365 suite of productivity tools—our customers have been asking us how they can migrate their Teams resources to a new tenant in the context of a merger and acquisition. Another question we’ve been hearing a lot of lately: Can the SPMT help me with my Teams migration?
Our engineers did a ton or research into Teams migration in the course of developing our latest ShareGate Desktop release, and part of that process included looking at the SPMT to understand the capabilities and limitations of the tool. To help you assess whether the features are enough to help you with your Teams migration, we decided to share what we learned and highlight some key differences between the SPMT and ShareGate Desktop’s Teams migration tool.
Microsoft Teams is a collaboration hub that simplifies the experience of working with Microsoft 365. When you use Teams, it’s leveraging the strengths of other Microsoft tools—such as SharePoint, Outlook, and OneDrive for Business—by packaging them together in a unified interface with persistent chat.
But that means that most Teams data isn’t stored in Teams. Teams data is actually stored in the following locations:
This data sprawl complicates the definition of a “Microsoft Teams migration”. Does the term refer to the migration of any, or all of the above? Can a Teams migration mean moving a team’s SharePoint content to a new tenant? What about conversation history? Or channel structure? Or all of the proper settings and members for each team?
The storage of Teams data in so many different locations also complicates the execution of a Microsoft Teams migration. A lack of publicly available APIs from Microsoft make it impossible to migrate Teams automatically using out-of-the-box solutions; and migrating Microsoft Teams data manually is extremely time-consuming and involves multiple steps, some of which need to be repeated for every single team.
Since its initial release at the beginning of 2018, Microsoft has continued to invest in its free SharePoint Migration Tool (SPMT)—releasing new features, additional sources, and improved PowerShell support.
One such update, announced via a Microsoft Tech Community blog post titled “Microsoft Teams migration with the SharePoint Migration Tool”, incorporated new Teams capabilities. But as commenters on the post were quick to point out, calling it a “Teams migration” could be a bit misleading depending on what, exactly, you’re trying to move and where.
So what can the Teams migration functionality of the SPMT help you do? To understand the answer to this question, you first need to have a good grasp on how Microsoft Teams and SharePoint integrate with one another.
Good to know:
This means that if you want to migrate content so that it appears in Teams—specifically, within each channel’s Files tab—you actually need to migrate that content to the associated SharePoint team site. And that’s where the SPMT comes in.
The SharePoint Migration Tool is designed to migrate content from SharePoint Server and file servers to SharePoint and OneDrive in Microsoft 365. Available to all Microsoft 365 subscribers as a free download, the SPMT provides a quick and simple solution for IT admins looking to bring their organization’s information to the cloud.
Wondering whether the SPMT is enough to successfully complete your SharePoint migration project? Check out our take on Microsoft’s free migration tool.
The Teams update mentioned earlier introduced Microsoft Teams as a target destination in the SharePoint Migration Tool. Since each team in Microsoft Teams has an associated team site in SharePoint Online, the Teams functionality in the SPMT is designed to help you map file data to the SharePoint folder structure created by Microsoft Teams.
What does this mean in the context of a Teams migration? Well, it means the SPMT lets you migrate lists or files into a Microsoft Teams document library from an existing SharePoint Server site or file share.
But it can’t help you migrate content from one Teams tenant to another. And the functionality doesn’t offer any sort of chat-based migration—like group chat and channel conversation history.
Additionally, you need to manually create the teams and channels at the destination beforehand so that you have somewhere to migrate your content to:
And while the SPMT has settings that enable you to automatically map users and preserve file share permissions, those controls don’t replicate team membership and permissions in Microsoft Teams—they only affect the SharePoint permissions on a file or folder when it’s migrated to Microsoft 365.
The SPMT permission control is also affected by various conditions. Check out the official Microsoft documentation for a full list of permissions conditions and results when using the SharePoint Migration Tool.
Essentially, the Microsoft Teams functionality in the SPMT is a repackaged version of the tool’s existing SharePoint migration functionality. It’s aimed at IT admins looking for an easier way to make existing on-prem files accessible in Teams so their users can take advantage of new methods of collaboration in Microsoft 365. If this is you, then the SPMT is a capable and easy-to-use migration tool.
However, if your organization has already moved to the Microsoft cloud, deployed Teams, and/or is trying to migrate Teams data in the context of a business merger or acquisition, then the SharePoint Migration Tool alone might not provide the functionality you’re looking for.
You could try to leverage the SPMT in the course of a manual Teams migration. But migrating Microsoft Teams data to another tenant manually involves multiple steps and a ton of heavy lifting on the part of IT, even with the SPMT.
Instead of jumping through tons of hoops to get your users up and running in their new Teams environment, why not use a third-party tool to simplify the process?
ShareGate Desktop, our SharePoint migration tool, enables you to perform a Teams migration in every sense of the term:
Our SharePoint migration tool offers the same functionality as the SPMT if you want to make existing on-prem content accessible in Microsoft Teams. In just a few clicks, ShareGate Desktop migrates your content from SharePoint Server or a file share to the appropriate channel folder in a team’s associated SharePoint site (or the appropriate document library in a private channel’s site collection).
Import content from a file share to a channel folder in a team’s SharePoint document library.
The release of ShareGate Desktop 13.0 introduced a dedicated Microsoft Teams migration feature to our popular migration tool. Migrate existing teams to another tenant—or copy teams within the same tenant—in just a few clicks. No need to manually re-create the teams you want to migrate at the destination first, and no need to script.
Choose which teams you want to migrate.
And you can migrate more than just your teams’ SharePoint content—we’ll also make sure all your teams’ data is migrated, too!
With ShareGate Desktop, you can bring along:
ShareGate Desktop also has copy options that let you customize and control your Teams migration. Automatically map users at the destination—so they can keep working quickly with the right set of permissions post-migration. Rename teams pre-migration. And schedule a convenient time for your migration to take place.
And now, with the release of ShareGate Desktop 14.0, you can choose to migrate a team and its data to a new team at your destination, or copy a team’s channels to an existing team.
Configure copy options before your Teams migration.
Also introduced with the release of ShareGate Desktop 14.0, you can now move public channels between teams to match how people collaborate and move inside your organization. Move a team’s entire list of public channels or only select the ones that are needed.
Select which channels you want to migrate, and only bring the ones you need to.
And choose whether to migrate channels to a new team or copy channels to an existing team—we bring over their conversation history, files, and tabs as well, so members can keep working without skipping a beat.
ShareGate Desktop also flags potential issues, like duplicate channel names, and prompts you to rename them before your migration, either by adding a prefix or suffix or changing the name completely.
Change the name directly in app before your migration takes place.
You can even use our Teams migration tool to copy teams within the same tenant—just connect to the same environment for both the source and destination. This is especially useful for building templates with pre-built channel structures and settings, so that you can easily create consistent teams across your organization.
Use the same “Copy teams” interface to migrate teams and channels within a single tenant.
We created this handy table to help you visualize the different functionalities that are available in the context of a Microsoft Teams migration.
For more details: Check out the official Microsoft documentation for the full list of SPMT supported features. And head to the ShareGate Desktop product page to learn more about what our Teams migration tool can help you do.
Supported… | SPMT | ShareGate Desktop |
---|---|---|
SOURCES | ||
File shares | ✔ | ✔ |
SharePoint Server | ✔ | ✔ |
SharePoint Online | ✔ | |
OneDrive for Business | ✔ | |
Microsoft Teams | ✔ | |
DESTINATIONS | ||
SharePoint Online | ✔ | ✔ |
OneDrive for Business | ✔ | ✔ |
Microsoft Teams | ✔* | ✔ |
OBJECTS | ||
Files & folders | ✔ | ✔ |
List items | ✔* | ✔ |
File & folder permissions | ✔* | ✔ |
Managed metadata & taxonomy | Content types and term stores; managed metadata migration is turned off by default, and taxonomy is updated in incremental rounds | Bulk manage and migrate customized metadata |
Site migration | Out-of-the-box sites only | Supports SharePoint site customizations |
Team settings & description | ✔ | |
Membership (owners and members) & permissions | ✔ | |
Conversation history | ✔ | |
Public channels | ✔ | |
Tabs, apps, & bots | ✔ | |
Default wiki pages | ✔ | |
OneNotes | ✔ |
Take a look at our support documentation to learn how to set up ShareGate Desktop!