Upgrade to the new Teams using policies

You can upgrade to the new Teams client to your organization by setting policies in either the Teams Admin Center or by using PowerShell.

Tip

As a companion to this article, we recommend using the Microsoft Teams Setup Guide when signed in to the Microsoft 365 admin center. This guide will customize your experience based on your environment. To review best practices without signing in and activating automated setup features, go to the Microsoft 365 setup portal.

Prerequisites

Requirement Version
Windows Windows 10 version 10.0.19041 or higher (excluding Windows 10 LTSC for Teams desktop app). Users of Windows N SKU need to enable Media Feature Pack for Windows 10/11 N
Webview2 Update to the most current version. Learn more: Enterprise management of WebView2 Runtimes
Teams app Version 1.6.00.4472 to see the Try the new Teams toggle.

If you are at a lower version, select the overflow menu (…) > Check for updates > Update. Then restart your app.
Office Microsoft 365 Apps or Office LTSC 2021 Learn more: Office versions and connectivity to Microsoft 365 services
Settings Turn on the "Show Notification Banners" setting in System > Notifications > Microsoft Teams to receive Teams Notifications.
Delivery optimization (DO) DO powers Teams automatic updates, which are required as part of the Servicing Agreement.

Overview: What is Delivery Optimization?
Recommended settings: Set up Delivery Optimization

Note: Download Mode 100 (Bypass) isn't supported.

Required Microsoft 365 Apps Security Updates

Channel Version & Build
Semi-Annual Enterprise Channel Version 2302 (Build 16130.20306)
Version 2208 (Build 15601.20578)
Monthly Enterprise Channel Version 2301 (Build 16026.20222)
Version 2212 (Build 15928.20294)
Office LTSB Version 2018 (Build 10396.20023)
Version 2021 (Build 14332.20481)

Learn more at Update History for Microsoft 365 Apps.

Note

The end of availability for classic Teams client is June 30 2024. For more information see End of availability for classic Teams client.

Set the policies to upgrade to the new Teams client

As an admin, you can manage how new Teams to your users.

To control which users can see the toggle, use the Teams admin setting UseNewTeamsClient under the TeamsUpdateManagement policy.

Manage this setting in the Teams Admin Center or using Teams PowerShell.

Configure setting via Teams Admin Center.

Policy settings for upgrade

Setting Description
Not enabled Use this value to hide the new Teams toggle switch. Users won't be able to opt in to the new Teams.
Classic Teams as default Use this value to have classic Teams the default version. The new Teams toggle switch displays to let users opt into the new Teams and switch back if needed. Note: This option was previously called Users can choose.
Microsoft controlled Default. The value lets Microsoft control whether the new Teams toggle switch is shown or not based on product readiness
New Teams as default
Rollout for the feature began in early August 2023
Use this value to make new Teams the default version. Users can switch back to classic Teams using the toggle.
New Teams only (Rolling out mid-February 2024) Use this value to make new Teams the default version and uninstall classic Teams after a fourteen-day period. Users don't have the option to switch back to classic Teams.

Important

Admins should know that they can always move forward in the steps to new Teams Only from any other point in the rollout schedule, but they can't move backwards in the steps from where they currently are. Some examples:

  • If a customer is currently in classic Teams default mode, they can go to new Teams default mode, or new Teams Only, by assigning those policy states. However, they can't move back to the AdminDisabled state.
  • If a customer is currently in new Teams default mode, they can move forward to new Teams Only by assigning that policy state. In this case, they couldn't move back to classic Teams default or AdminDisabled.

In addition to PowerShell, you can also use Teams Admin Center to manage the visibility of the toggle on a per-user basis.

  1. Sign in to the Microsoft Teams admin center.

  2. Select Teams > Teams Update policies from the left navigation pane.

  3. Select Add to create a new policy or select an existing policy to open Update policy.

  4. Name the update policy, add a description, and select the setting for “Use new Teams client”, as shown here.

    update policies add a new policy

Setting Description
Not enabled Use this value to hide the new Teams toggle switch. Users won't be able to opt in to the new Teams.
Classic Teams as default Use this value to have classic Teams the default version. The new Teams toggle switch displays to let users opt into the new Teams and switch back if needed. Note: This option was previously called Users can choose.
New Teams as default Sets the new Teams as default. Note: This option is currently being rolled out
Microsoft controlled Default. Use this value to let Microsoft control the following:
-Whether the "Try the new Teams" toggle switch is shown or not
- In the future, let Microsoft manage the installation of the new Teams client and
Allow Microsoft to determine default client behavior based on the rollout schedule.

Note

The option "Classic Teams as default" was previously called "Users can choose".


  1. Select new Teams as default from this setting to ensure users can get the new Teams experience when they launch

  2. Once the policy is defined, you can assign it to a user or user group with the Group policy assignment. To assign it to a group, select Group policy assignment and then Add, or select one of the groups listed.

update policies by group

Select a policy to assign to the group.

update policy and assign by group

  1. Once the policy is defined, you can assign it to a specific user under Users> Manage users.

update policy per user

If you update the policy setting in the Teams Admin Center, the new setting can take up to 24 hours to go into effect. The user doesn't have to restart the app.

How to uninstall the new Teams client

Any user who was using the new Teams before the policy was implemented can manually opt out by using the new Teams toggle.

After they opt out, the toggle won't appear when they relaunch Teams. To prevent users from using this client and want to uninstall the client, users can manually uninstall it from settings.


Remove new Teams for all users

To remove the new Teams from all users' computers, use the following PowerShell command:


Remove-AppxPackage 

PowerShell cmdlet to remove new Teams from all users on all computers:

Get-AppxPackage *MSTeams* -AllUsers |Remove-AppxPackage -AllUsers

PowerShell cmdlet for an individual user without administrator privilege:

Get-AppxPackage *MSTeams*|Remove-AppxPackage

Command to uninstall teams machine-wide: teamsbootstrapper.exe -x -m

Note

If you've set Teams update policy to Not enabled, but users still received new Teams client with M365 Apps, please follow instructions in our How to uninstall the new Teams client article to uninstall it for your users.

User settings migration

End user settings are automatically migrated from classic Teams to new Teams during the initial switch.

Note

Settings are only migrated once, the first time a user updates to new Teams. After that, no incremental migrations of setting changes will occur if the user switches back and forth between classic and new Teams.

Migrated settings

Local settings that are automatically migrated when switching from classic Teams to new Teams:

Area Item
General Chat density
Show message previews in your chat list
App Language
> Display > Turn off animations
Devices Audio devices
> Audio devices > Speaker
> Audio devices > Microphone
Noise suppression
High fidelity music mode
Secondary ringer
Camera
Automatically adjust mic sensitivity
Files and Links Downloads: Location
Downloads: Always as where to save downloaded files
File open preference: Always open word/ppt/excel files in...
Custom Background image files On-disk image files
Call/Meeting Stage Background Effects, blur