Troubleshooting installation issues in the new Teams client
Policy settings restricting download & install
If your users are experiencing issues installing the app, as an administrator you can set some restrictions preventing them from downloading and installing it. They could see this error:
It’s possible that the MSIX package installation could be blocked by registry keys set by GPO policy/third party tool. For a complete list of registry keys: How Group Policy works with packaged apps – MSIX.
The registry keys that could block new Teams MSIX package installation are:
- BlockNonAdminUserInstall
- AllowAllTrustedApps
- AllowDevelopmentWithoutDevLicense
Important
If AllowAllTrustedApps is disabled, the new Teams app (MSIX) installation fails. This issue has been fixed in the Windows October cumulative update KB5031455. If this optional October update isn’t available for your OS build, the November security update will include the fix.
- Windows 10: October 26, 2023—KB5031445 (OS Build 19045.3636)
- Windows 11: October 26, 2023—KB5031455 (OS Build 22621.2506)
These registry keys can be found at one of these locations:
- Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
- Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx
There are a few policies that could alter these registry keys and block app installation in your organization due to restricted policy set by the admins. Some of the known GPO policies that could be preventing installation include:
- Prevent non-admin users from installing packaged Windows apps
- Allow all trusted apps to install (disabled)
To check this setting for your computer
- In Windows, search for Edit Group Policyor right-click the Windows Key and select Run > enter “gpedit.msc”.
- This action opens the Local Group Policy Editor screen.
- Go to Go to Computer Configuration > Administrative Templates > Windows Components > App package Deploymentto check settings for these policies:
- Prevent non-admin users from installing packaged Windows apps
- Allow all trusted apps to install
- Make sure that value for these settings is set as follows:
Expand table
| Setting | Value |
| Prevent non-admin users from installing packaged Windows apps | Not configured |
| Allow all trusted apps to install | Not configured |
Note
Admins who are bulk deploying new Teams to their organization’s computers, see:
Troubleshooting the App switcher toggle
- Relaunch your current client before turning the Try the new Teamstoggle ON to make sure that you have latest changes. Also, if there’s any Windows update pending, including security updates, install them before you try new Teams.
- If you’re not seeing the toggle for new Teams, make sure you have the minimum required versions for Windows and Teams.
- After you successfully switch to new Teams: If you can’t find the toggle on the top left to switch between new Teams and Microsoft Teams (work or school), start the version you want by going to Start menu and searching for it or by selecting it from the task bar.
Policies that could block the user from seeing the App switcher toggle
The following list of policies can block users from seeing the app switcher toggle.
- Your admin has sign in restrictionsset up Learn more about how to restrict Teams sign in on desktop devices.
- If the user is on a VDI computer (Citrix, VMware etc.).
- If the user is signed in to classic Teams with a Teams for Lifeaccount and a work account.
- If the user is signed in to classic Teams with a Teams for Life
How do I know which one of the above policies is blocking me?
- Open logs in this path: %appdata%/Microsoft/Teams.
- Open logs.txt.
- Search for appswitcher_appstateservice_check.
- Check the enggCompleteflag:
- If true, Microsoft turned the setting on for you.
- If false, you didn’t the settings from MSFT yet or need an app relaunch (there are for steps to relaunch the app included in this article).
- Check isAboveWin10Vibranium.
- If true, the OS version is >= what is needed for app switcher.
- If false, the OS is older than what we support.
- Check the code to find out the cause.
Expand table
| Code | Meaning |
| TFLONLY | You’re only signed in to Teams for Life |
| TFLANDTFW | You’re signed in to Teams for Life and Teams for Work |
| SPECIALCLOUD | You’re signed in to a special cloud that isn’t supported. |
| CROSSCLOUD | You’re signed in to a government cloud. |
| VDI | You’re signed in to a VDI machine (VMware, Citrix, AVD/WV). |
| SIGNINRESTRICTED | You’re signed in to the specified tenant but the App switcher toggle doesn’t appear. |
Update and restart message in title bar
Issue: After a user opts into the new Teams, they might receive an Update and restart message in the title bar. Action: This messsage is an expected behavior. Select the link to restart.
Windows 10 users can receive an error message
Issue: Windows 10 users could receive the error “We’ve run into an issue” when they download and install the new Teams.
Action: Download and install WebView2 Runtime. Then restart the Teams desktop app and try again.
Some people don’t see the toggle to opt in
Make sure the user has the minimum requirements met on their computer. Next, have them sign out and back into the Teams desktop app.
If the toggle still doesn’t appear, then:
- Right-click on the Teams app icon in your taskbar and select Quit.
- Open File Explorer. In the address bar, enter the following text: %appdata%/Microsoft/Teams.
- Select the arrow, or press Enter. You’re taken to the contents of that folder.
- Delete all contents of the folder (don’t worry, Teams app won’t be deleted, and no or on any of your custom settings). If you get any messages that a certain file or folder can’t be deleted, select Skip.
- Relaunch the Teams app, then right-click on the icon and select Quit.
- Relaunch the Teams app one more time, and you should see the toggle switch.
Download and install even if group policy is set to disabled
You might still be able to download and install the new Teams even if you have “Allow all Trusted apps” group policy set to disabled.
- If you’re running Windows 10 or Windows 11 patch 10D version or higher, you can still download and install the new Teams app
- If you’re running Windows 11 21H1 SV1 (Build 10.0.22000) you will remain blocked.You must upgrade to a newer version of Windows 11 to use the new Teams.