Follow these steps in order, as they address the most common causes of new Teams installation failures and related Windows issues on a new device:
- Run the official pre-installation check
- Run the pre-installation check script for new Teams to automatically detect common blocking issues and apply the suggested resolutions.
- After applying any fixes suggested by the script, try installing Teams again.
- Check for organization policy blocks
If the error message during install is similar to:
Due to org policy, you can't install the new Teams. For more info, contact your IT admin.
then installation is being blocked by policy.
- Open the Local Group Policy Editor (gpedit.msc).
- Go to:
- Computer Configuration → Administrative Templates → Windows Components → App package Deployment
- Ensure these policies are set to Not configured:
- Prevent non-admin users from installing packaged Windows apps
- Allow all trusted apps to install
- If these are managed by an organization, contact the IT admin to relax or correct the policy.
- Verify and fix registry keys that block MSIX installation
New Teams uses an MSIX package, which can be blocked by certain registry values.
- Open Registry Editor and check these locations:
-
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
-
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx
- Look for these values:
-
BlockNonAdminUserInstall
-
AllowAllTrustedApps
-
AllowDevelopmentWithoutDevLicense
- If AllowAllTrustedApps is set to 0 (disabled), new Teams MSIX installation fails on older builds. Either:
- Install the Windows October cumulative update (or later) listed in the documentation for the OS version, or
- Manually set AllowAllTrustedApps to 1, then retry installing Teams.
- Confirm Windows version/build supports new Teams
- Run
winver.
- If the build is older than the versions listed for Windows 10/11 in the documentation, install the latest cumulative updates.
- If running Windows 11 version 21H1 SV1 (Build 10.0.22000), upgrade to a newer Windows 11 version, as that build remains blocked for new Teams.
- Fix issues with the Teams app switcher toggle (if applicable)
If classic Teams is installed but the Try the new Teams toggle is missing:
- Restart the current Teams client and install any pending Windows updates first.
- Ensure the device meets minimum requirements for Teams and Windows.
- If the toggle still does not appear:
- Quit Teams from the taskbar icon.
- Go to
%appdata%/Microsoft/Teams and delete all contents (this does not remove the app itself or custom settings at the account level).
- Restart Teams, quit it again, then restart once more.
- Check for conditions that block the app switcher
If the toggle is still missing, check for these conditions:
- Signed in with a Teams for Life (personal) account only, or both personal and work.
- Using a VDI environment (Citrix, VMware, AVD/WV).
- Sign-in restrictions configured by an admin.
To confirm the blocking condition:
- Open
%appdata%/Microsoft/Teams/logs.txt.
- Search for
appswitcher_appstateservice_check.
- Check:
-
enggComplete – whether Microsoft has enabled the setting.
-
isAboveWin10Vibranium – whether the OS version is supported.
- The code (e.g.,
VDI, TFLONLY, SIGNINRESTRICTED) to identify the cause.
- Repair search bar and Windows search issues
Because Teams and Store/MSIX behavior can be affected by system-level issues, also:
- Ensure Windows is fully updated.
- Run built-in troubleshooters for Search and Indexing from Settings → System → Troubleshoot → Other troubleshooters.
- Verify that the TEMP/TMP and Cookies/Cache shell folders are not pointing to reparse points (as described in the Teams launch-issues article), and correct them if they are.
- If Teams still will not install or launch
- Use the TeamsLaunchCheck.ps1 script from the launch-issues article to run all diagnostic checks automatically.
- If the script or manual checks show permission or profile corruption issues, a local administrator may need to:
- Fix permissions on the AppData paths listed in the documentation, or
- Delete and recreate the user profile on the device.
If, after these steps, Teams still fails to install and search remains broken, the underlying Windows configuration may be significantly damaged; in that case, a repair install or reset of Windows may be required before retrying Teams.
References: