Microsoft Teams Migration FAQs

This guide will cover frequently asked questions and troubleshooting processes related to Microsoft Teams to Microsoft Teams migrations. It is not intended to replace any part of the migration guide, which lays out the steps necessary to perform a Teams to Teams migration. 

What data will be migrated?

MigrationWiz can migrate most of the data within Teams, but there are some limitations. The following list explains which items will be migrated, which won't, and any limitations or special considerations. 

Migrated Not migrated
  • Teams
    • Public
    • Private Teams
    • Organizational -

      When organization-wide teams are migrated, they appear as public teams at the destination. As a workaround, the admin will have to change the privacy to organization wide teams via the UI.

    • Archived teams - moved as public teams and must be re-archived at destination.
  • Channels - all public channels are migrated. 
    • Conversations
    • Structure
    • Format
    • Root messages
    • Replies
    • Fonts
    • Bulleted & numbered lists
    • Colors
    • Quotes
    • Emojis
    • Inline images and stickers
    • Code snippets
    • Hyperlinks
    • GIFs
    • Deleted message notifications
    • Mentions (as plain text to prevent duplicate notification after migration)
    • Timestamps (in UTC)
    • Private conversations and files under the Chat tab
    • Private chats (1:1, group chats, meeting chats)
  • All files are migrated from the default document library associated with the Team or Private Channel. 
  • Memberships: All memberships are migrated.
  • Guest user permissions
  • OneNote Documents and tabs
  • Planner, including tabs, plans, buckets, and tasks

MigrationWiz only supports document migrations from SharePoint for Collaboration migrations. We do not support migrations from any other storage point.

  • Likes/Reactions
  • Links to files and meeting requests in conversation threads
  • File previews
  • Teams meeting recordings
  • Hyperlink previews
  • Calendar previews
  • User-specific settings (Favorites, Profile pictures, Status messages, and saved messages)
  • Dynamic groups (the groups will be migrated, however, they will be migrated as static groups)
  • Tabs (Website tabs, Word, Excel, PowerPoint and PDF tabs, Document Library tabs, Wiki tabs, Microsoft Stream tabs, PowerBi, SharePoint page and list tabs, Custom tabs)

  • Customized Team settings (these include team picture, member permissions, guest permissions, mentions, etc. New Teams will be created with the Default settings)
  • Team list order (after migration, Teams will not appear on the destination in the same order as on the source. Users can drag and drop to reorder the list of teams)
  • Wikis
  • Tags (after migration, the name of the tag will be in plain text if it was included in a conversation)
  • Private channels of archived teams - this is a Microsoft API limitation.
  • Channel tabs from Archived teams.

A note about private channels

Due to Microsoft limitations, private channels are not migrated for GCC High Tenants.

Migrating guests

Guest access on the source will be migrated if the guest exists and guest permissions are enabled at the destination tenant prior to migration. This may be done via the Teams or Office 365 admin portal.

Other Limitations

1. Conversations

A Conversation History tab will be created for each corresponding channel at the destination. Each team will show the most recent 60 conversation threads (60 root messages + all replies), while all older message threads may be downloaded as an HTML file in the Conversation History tab.

This number may be increased through the use of the advanced option:TeamsMaxConversationPostPerTeam=XXXX. Replace XXXX with the number of message threads you wish to migrate. E.g.

TeamsMaxConversationPostPerTeam=1000 would load 1000 conversation posts per team. This total is split between channels that are in each Team e.g. If there are 10 channels in a Team then you would see 100 conversation posts migrated per channel. This may slow your migration, so plan accordingly if you use this option. 

2. Teams for Education Migration 

MigrationWiz can assist with the migration of Microsoft Teams for Education (Classroom template only, including Classroom Notebook). We currently do not support the migration of Notebooks for Teams based on PLC or Staff templates.
Note: Teams based on these templates will need to be provisioned in the destination prior to migration. Please contact Sales for more information.

3. GoDaddy 

Due to limitations on connections allowed by GoDaddy, we do not support migrating to or from GoDaddy using this migration type.


How long does the Azure SAS token last for the Microsoft-provided Azure Storage?

The Azure storage SAS token Microsoft provides to us last only 5 days instead of 30 days.

Adding app permissions

  1. Ensure you are signed in as a Global Admin in the Office 365 Admin Portal.

  2. Go to MigrationWiz-Teams-FullControl and consent to the app access when prompted. 

  3. Create new Security Group named “MigrationWiz” on the Office 365 Admin Portal. If you have not created a security group before, follow Microsoft's instructions.

  4. Create new user. This user must have an active Teams license applied.

  5. Add new user to previously created security group as a member. Important: ADFS and MFA must be turned off for this user.

  6. Create MigrationWiz project.

  7. When creating the endpoints, enter the new user credentials.

Steps to enable permission level at the destination:

  1. Ensure you are signed in as a Global Admin.

  2. Go to MigrationWiz-Teams-FullControl and consent to the app access when prompted.

  3. Create new Security Group named “MigrationWiz” on the Office 365 Admin Portal.

  4. Create new user. Important: ADFS and MFA must be turned off for this user.

  5. Add new user to previously created security group as a member.

  6. Create MigrationWiz project.

  7. When creating the endpoints, enter the new user credentials.

MigrationWiz-Teams-FullControl may be used on both source and destination tenant and will export document permissions. 

Post-Migration Steps

  1. Remove the newly created user.

  2. Remove the MigrationWiz Security Group created in Step 3.

  3. To remove the app from the source or destination, perform the following steps:

    1. Launch PowerShell.

    2. Connect PowerShell to Office 365.

    3. Enter the command: Connect-AzureAD

    4. Enter the admin credentials in the prompt.

    5. Enter the command:Get-AzureADServicePrincipal -SearchString Migration

    6. Look for the ObjectId of the app you want to remove and enter the following command: Remove-AzureADServicePrincipal -objectId <the object id>

Adding Teams & Autodiscovery

What is the difference between the previous Assessment and Autodiscovery?

Assessment previously would calculate the number of teams, number of users file size and licenses needed.

Autodiscover will only discover the total number of teams at the Source

As such, from a speed perspective, autodiscover should be relatively faster than the Assessment. Once auto-discover has completed, users can import the teams and all the teams will be populated as line items.

What should I do when auto-discovery fails?

Check your Source credentials. Auto-discover will fail if the credentials verification fails.

What will Folder Summary show?

Folder summary will be shown per team level, so all the channels, documents and document permissions specific only to that team.

Migrating Teams

Can I select which Teams to migrate?

Yes, by checking only those teams to be migrated after the adding of teams is done either via auto-disover, quick add or bulk add.

Can I migrate only specific users?

No. All users in a selected team will be migrated.

How do I apply user mapping for large number of users?

  1. Download the script and example file attached at the end of this article (Add-MWTeamsUserMapping.ps1 and

  2. Fill in the example.csv with the desired user mapping

  3. Retrieve your Teams project ID. This can be obtained by copying the text after the projects/ and before the ?, as shown below.Teams_User_ID.png

  4. Run Powershell as an Adminstrator.

  5. Run this command:

    Set-ExecutionPolicy Unrestricted -Scope CurrentUser
    cd <Download folder>
    .\Add-MWTeamsUserMapping.ps1 -projectId <Teams project id> -csv <your csv path>
  6. E.g: .\Add-MWTeamsUserMapping.ps1 -projectId b2b00b67-c6fc-11ea-a81a-000d3af5b517 -csv .\example.csv

  7. Enter your MigrationWiz Account username and password.

  8. Input the path to the CSV file with the user mapping.

Can I rename a team before migration?

Yes. However, only the MailNickname gets renamed. There will not be any changes to the Display Name. Prepend/AppendFolder AdvancedOptions is no longer supported for the Teams connector.

Can I migrate a Team to an existing Microsoft 365 group that is NOT Teams enabled at the destination?

Yes, you can migrate a source Team to an existing Microsoft 365 group in the target tenant even if it is not a Teams-enabled group. We will enable it for you in the "Teams Creation" pass. We then proceed to migrate the source data as expected behavior in a Teams migration.

Are Teams permission migrated?

Yes. We recommend migrating the permissions last to ensure owners and members at the destination do not get e-mail alerts to access incomplete Teams.

If a team at the destination exists with the same name as a team at the Source tenant, can I rename the specific Team before the migration?

Yes. Click on the Edit icon of the team/line item and change the Destination MailNickname.

Can I migrate Teams with special characters in the name?

Yes. The steps for this are included in the Teams to Teams Migration Guide.

Can I migrate archived Teams?

Currently, archived teams are migrated over as a non-archived team. Private channels of archived teams will not be migrated. Channel tabs from archived teams will not be migrated. This is a known Microsoft API limitation.

SharePoint sites are live in the destination. Will the Teams automatically connect to the SharePoint sites after Teams have been migrated? 

No, because this is dependent on Microsoft Teams, we don’t have control. Once a team is created, a new SharePoint site will be created for that team.

Migrating Private Channels

Can I migrate private channels belonging to an archived team?

No. This is still a Microsoft API limitation.

Can I skip private channel migration?

Yes, add the Advanced Option TeamsSkipPrivateChannel=1 into the project before starting the migration

Are there any prerequisites that I must take care of on my destination Tenant before migration?

Please ensure that destination tenant does not restrict creation of private channels.

Migrating OneNote Documents & Tabs 

Does MigrationWiz migrate OneNote documents and tabs?

Yes, MigrationWiz supports OneNote documents & tabs migration. There will be a new optional item type, OneNote tab, in the Start Migration flyout.

However, OneNote tabs can only be migrated after the initial migration of documents and the OneNote instance. We also recommend waiting at least four hours after the initial document & OneNote migration has completed before starting the OneNote tabs migration.


Can I see which OneNote tabs have been migrated? 

Yes. Migrated OneNote tabs will be reflected in the ‘Folder Summary’ section of the respective team/channel. The Migrated Items section will also show the total number of OneNote tabs migrated.

How do I migrate OneNote tabs? 

  1. Ensure the MigrationWiz User has already consented to either Teams-ReadOnlyApp or MigrationWiz-Teams-FullControl.
  2. Log in to MigrationWiz.
  3. Create a Teams Collaboration project.
  4. Start adding Teams via Autodiscover, Quick Add, or Bulk Add. Steps for these processes are included in the Teams migration guide. 
  5. Select which teams to migrate.
  6. Click Start Migration for a ‘Teams Creation’ pass first.
  7. Wait 24 hours for the Teams to provision. 
  8. Migrate Data without OneNote tabs.
    1. Select teams to migrate.
    2. Click Start Migration with ‘Documents and OneNote’ with any other item types but do not select OneNote Tabs.
    3. Wait approximately 4 hours for the OneNote documents to be discovered by the OneNote service.  
  9. Migrate data with OneNote tabs. 
    1. Select ‘OneNote tabs’ and any other item types which still need to be migrated. 
    2. Documents and OneNote can be selected again to bring over any newly created documents since the last migration.  

What items are migrated? 


OneNote Notebook migrated from destination?

OneNote Tabs created at the source?

Default/existing OneNote notebook of the Team



New OneNote notebook created in the team



OneNote notebook that was originally created/added in a parent Team and thereafter added as a link into the private channel of that team



OneNote notebook that was originally created/added in the private channel itself



OneNote notebook present in another team’s SharePoint site

:check_mark: Only if this other team has already been migrated in MigrationWiz


Personal OneNote (stored in personal OneDrive)



OneNote Documents
Only OneNote documents relevant to the team/line items in the project will be migrated.

OneNote Tabs
For private channels, if the OneNote document is originally created/added in the private channel itself, contents get migrated but tabs cannot be created.
However, if the OneNote tab was originally created/added in a parent Team and thereafter added as a link into the private channel of that team, OneNote contents gets migrated with the OneNote tab created.

What items are not migrated? 

  • A OneNote document present in an individual user’s OneDrive account
    (This will be migrated via the standard MigrationWiz document project. A warning message will be shown).
  • Personal OneNote instances and non-Teams OneNote instances will not be migrated.

What are the OneNote migration limitations?

OneNote Notebooks

  1. If the source team name and destination team name are different, and the destination team notebook is already provisioned, default mapping will apply. This means that contents in the source notebook will be automatically migrated to the destination notebook even though the team names are different.

  2. If the source team display name and the destination team display name are different, and the destination team notebook was not provisioned due to Microsoft limitations, the source notebook will be migrated as-is.

  3. Source default notebook content will be migrated but will not show as the default if the destination notebook has not been provisioned.

OneNote Tabs

  1. If the OneNote associated with the tab is not stored in the specified team, the OneNote tab will not be created at the destination. A warning message will be shown. This may be due to a changed personal OneDrive URL or from a lack of visibility into other teams and their migration status.

What happens if the OneNote tab migration fails?

If there are migration failures of OneNote tab migrations, perform "Reset Items" to reset errors before resubmitting the migration. Otherwise, all OneNote notebooks and tabs will be recreated.

Can the OneNote documents & tabs migration be skipped?

Yes, add Advanced Option TeamsSkipSiteAssets=1 in order to skip OneNote migration.

Migrating Conversations

Are all conversations migrated?

60 message threads (60 root messages + all replies) per team will be displayed in the destination team.

MigrationWiz will gather the total number of channels in each team  and then grab the most recent 60 threads in each team. The conversations will be distributed across those channels. For example, if you have six channels in a team, you will have ten message threads per channel. This number can be controlled with the TeamsMaxConversationPostPerTeam Advanced Option. Details on this process are found in the migration guide. 

The entire channel conversation history can also be downloaded as HTML in the ‘Conversation History’ tab.

How does MigrationWiz choose 'most recent'?

It is based on the age of the root message. If you reply to an old message, it will not be counted as the most recent.

Private Chats

Are private chats migrated? 

Yes, private chats, including 1:1 chats, group chats, and meeting chats are migrated.

Are the private chats rehydrated into Teams at the destination tenant?

No. This is currently a Microsoft API limitation.

What license is required to migrate Teams Private Chats?

Mailbox or UMB license.

Can Teams private chats be migrated as a standalone without migrating the rest of the mailbox items, or if the other mailbox items have already been migrated? 

Yes, just select the Teams private chat item type during ‘Start Migration’ and deselect the rest of the item types.

Can the ‘Migrated Teams Chat’ folder be renamed?

Yes, use the Advanced Option MigratedTeamsChatFolder=RenamedFolderName
Change the second part of the stream to the folder name you wish to map to on the destination. Example: MigratedTeamsChatFolder=My Teams Chat will appear as ‘My Teams Chat’ instead of ‘Migrated Teams Chat’.
This option should be added at the project level before starting the migration. If folder has to be renamed again after a migration pass, the older folder that was already migrated should be deleted, reset and re-run the migration.

Can the 'Migrated Teams Chat' folder be hidden after migration? 

Yes, use the Advanced Option HideMigratedTeamsChatFolder=1

By default, the 'Migrated Teams Chat' folder is visible after migration if the Advanced Options is not added. 

Is it possible to migrate Teams private chat for a specific duration? 

Yes, use the date filter in the Advanced Options configuration page.

Is pre-stage migration supported for Teams Private Chat?

Yes, for pre-stage migration, either select only ‘Mail’, only ‘Teams Private Chat’ or both.

Why must OneDrive migration be completed prior to migrating Teams Private Chat? 

All files or links shared in Teams Private Chats are stored in the sender’s OneDrive folder.
Migrating OneDrive ensures links or attachments within private chats will be mapped correctly and migrated over to the destination. Otherwise, migration will succeed but the links will not be accessible.

Migrating Guests

Are guests/external users migrated?

Guest access on the source will be migrated if the guest exists and guest permissions are enabled at the destination tenant prior to migration. This may be done via the Teams or Office 365 admin portal.


Team members are missing at my destination. How do I resolve this?

Teams with a large number of members may take longer time to sync. To verify that all members have migrated:

  • Log into

  • Go to the migrated group (Team).

  • View the members list to verify that the correct number of members were migrated.

  • This should be synced to the Teams interface in the next few hours.

Government Migrations 

Can I migrate to or from a US Government tenant?

Yes, via Advanced Options. Refer to the migration guide.

Does GCC support the Teams application permission Advanced Option?

No, currently GCC does not support the use of application permission (UseApplicationPermission=1). Add the option UseDelegatePermission=1 instead.

Black Forest Tenant Migrations

Teams migration is currently not supported for Black Forest Tenants in the Microsoft Germany Datacenter, as it was not rolled out there to the best of our knowledge, nor could we obtain a test environment. For German customers in a .com Microsoft 365 instance, Teams and migrations to and from should work normally. For US Government tenants, we currently support it as a destination. Source is as yet untested.

Advanced Options

User Mapping Troubleshooting

If the user is not found at the destination (with or without mapping), MigrationWiz will throw a warning message indicating that the particular user is not found and will not be added to the migrated teams. To fix this, make the correction to user mapping and re-migrate with 'Team Permission' selected.

Does UserMapping refer to the UPN or to the SMTP?


Was this article helpful?
0 out of 2 found this helpful