Microsoft Teams: Current Landscape for Teams Tenant Migration

Many organizations are starting or quickly ramping up their Microsoft Teams adoption.   After adoption has begun, merger, acquisition, or even regulatory requirements can create a need for Microsoft Teams Tenant consolidation or divestiture.  While the situation is changing quickly the current state of migration scenarios and tools for Teams migration between Tenants presents a number of challenges.

Microsoft Teams Architecture

A Microsoft Team relies on the following services, at a minimum:

  • an Office 365 Group (which are Azure AD groups).  Membership and ownership live here.
  • an Exchange Online Mailbox associated to the Office 365 Group. Some emails sent to the Microsoft Team are stored here as well as channel chat history (in a hidden folder for compliance and discovery).
  • a SharePoint site.  A SharePoint document library provides the file  . Channel specific emails go to the document library folder for that channel.
  • An Azure Chat Service for channel chat.
  • Individual user mailboxes are used to store “direct” chats – that is, chats between users that don’t occur in a Team channel.

Team members and owners can readily add tabs to a team channel for a wide range of Microsoft 365, Azure, and third-party services.  Examples include Planner, Power BI, Azure DevOps, OneNote notebooks, JIRA, StackOverflow, Flow, Trello, etc.

Team Tenant Moves


Compelling and Complicated

Microsoft - The Essential Guide to Microsoft Teams End-User Engagement
The Essential Guide to Microsoft Teams End-User Engagement

We take you through 10 best practices, considerations, and suggestions that can enrich your Microsoft Teams deployment and ensure both end-user adoption and engagement.

Get the Guide

The integrations with Microsoft 365, Azure, and third-party services make Microsoft Teams usage compelling.  As a Microsoft Team member, you and your team can extend your Microsoft Team into a supercharged collaboration environment and productivity boosting dashboard, adding Tabs for a number of Microsoft 365, Azure, and third party applications.  For many adopters, Microsoft Teams becomes the primary user interface used during a large part of the workday.  However, this level of integration with and reliance on so many services makes migration of a Microsoft Team to another Microsoft 365 Tenant a complicated challenge for migration personnel and for migration tool builders.

Common Microsoft Team Migration Experience

At this time, Microsoft does not provide a migration tool or experience for Teams.  However, several third parties have developed or adapted tools to provide migration solutions. Community created PowerShell scripts also can help in certain scenarios. In every case, at this time, the migration experience is less than a full fidelity experience.

Causes of the limitations:

  • limitations of the underlying APIs for Teams, especially for retrieval and replay of Team channel chat history
  • varying storage locations for the data
  • varying underlying APIs for the services/data represented in the tabs users have added

Commonly, most solutions do migrate the following (each migration solution will, of course, have subtle differences):

  • underlying Group/Team membership (watch out for Dynamic Groups, however, which may be migrated as static groups) for any type of Team (Public, Private, or Organization wide)
  • Team channels and files (via the underlying SharePoint site)
  • Team channel chat history (although often in a truncated and/or archive format)

Common Microsoft Team Migration Experience Gaps

Common gaps in the migration experience will be

  • Team channel chat history migration and representation in the target tenant (API limitation).  The history may be present but not in its full original form.
  • No migration of likes/reactions (API limitation) (this limitation also affects Discovery and Compliance scenarios)
  • No migration of private chat history (because this data is contained in user mailboxes and may be migrated with the mailbox but often that migration will have a separate timeline and effort from the Teams migration)
  • No migration of user specific settings
  • No migration of Team tabs – Tabs such as Planner, Power BI, OneNote, and many others require third-party or manual solutions.


Microsoft Teams provides a transformational collaboration experience for today’s teams and their projects.  Teams provides the integration glue that holds together so much collaborative goodness, but the result is a complex Teams Tenant migration story.  The nature of Teams integrations and extension means that there are likely to be gaps in the migration experience for the foreseeable future, especially for extensively used Teams that take advantage of a full range of Teams capabilities.  That’s understandable, but we should also collectively encourage Microsoft to provide better tenant portability for the core Teams workloads.

About the Author

More from this Author

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.