Edit

Troubleshooting installation issues in the new Teams client

  • Article
  • Applies to:
    Microsoft Teams

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:

error when policies restrict install

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.

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

  1. In Windows, search for Edit Group Policy or right-click the Windows Key and select Run > enter "gpedit.msc".
  2. This action opens the Local Group Policy Editor screen.
  3. Go to Go to Computer Configuration > Administrative Templates > Windows Components > App package Deployment to check settings for these policies:
  • Prevent non-admin users from installing packaged Windows apps
  • Allow all trusted apps to install
  1. Make sure that value for these settings is set as follows:
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 Teams toggle 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 restrictions set 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 Life account and a work account.
  • If the user is signed in to classic Teams with a Teams for Life account.

How do I know which one of the above policies is blocking me?

  1. Open logs in this path: %appdata%/Microsoft/Teams.
  2. Open logs.txt.
  3. Search for appswitcher_appstateservice_check.
  4. Check the enggComplete flag:
    • 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).
  5. Check isAboveWin10Vibranium.
    • If true, the OS version is >= what is needed for app switcher.
    • If false, the OS is older than what we support.
  6. Check the code to find out the cause.
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:

  1. Right-click on the Teams app icon in your taskbar and select Quit.
  2. Open File Explorer. In the address bar, enter the following text: %appdata%/Microsoft/Teams.
  3. Select the arrow, or press Enter. You're taken to the contents of that folder.
  4. 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.
  5. Relaunch the Teams app, then right-click on the icon and select Quit.
  6. 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.