Installing or updating the Teams app for education users across supported platforms
Try these steps in order:
- Check whether Teams works in a browser first.
- Open the web version: https://teams.microsoft.com/
- If the desktop app is blocked or broken, this confirms the account can still access Teams while the app issue is being fixed.
- Sign out of Teams completely and restart it.
- In Teams, select the profile picture at the top right.
- Select Sign out.
- Close Teams, reopen it, and sign in again.
- Clear the Teams cache on the laptop.
- This removes local app data that can cause reinstall or startup failures.
- On Windows:
- Right-click the Teams icon in the taskbar and select Quit.
- Open File Explorer.
- Paste this path:
%appdata%\Microsoft\Teams - Delete the contents of that folder.
- Restart Teams and sign in again.
- Note: clearing the cache does not remove Teams, but it does remove local cache items such as thumbnails, icons, local message history, display images, and add-ons.
- If Teams still will not install or reload, uninstall and reinstall it.
- Reinstalling can fix a corrupted local installation or incomplete update state.
- If the install error mentions organization policy, check Windows app-install restrictions.
- The new Teams installation can be blocked by these registry-controlled settings:
-
BlockNonAdminUserInstall -
AllowAllTrustedApps -
AllowDevelopmentWithoutDevLicense
-
- These are found under:
-
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock -
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx
-
- Important: changing registry or policy settings can affect app installation behavior across the device. Use caution.
- The new Teams installation can be blocked by these registry-controlled settings:
- Update Windows if installation keeps failing.
- A known issue where
AllowAllTrustedAppsbeing disabled blocks new Teams MSIX installation was fixed in later Windows updates. - Install the latest available Windows updates, then try the Teams install again.
- A known issue where
- If the laptop is on Windows 10 and the installer shows a WebView2-related error, install WebView2 Runtime, then restart Teams and try again.
If the device is managed by a school or organization and the error says Due to org policy, you can't install the new Teams, the install is being blocked by device policy and requires an IT admin to change that setting.