how to fix "something went wrong" in the teams desktop app
Fixes something went wrong in the Teams desktop app: cache clear, reinstall, and account checks. Use for the generic Teams error screen. Not for meeting audio issues.
TL;DR
Something went wrong in Teams is the app's generic failure screen, most often a corrupt cache or a broken install. Clear the Teams cache first; that fixes the majority. Reinstall only if the cache clear fails.
The query
how to fix "something went wrong" in the teams desktop appUse this when
- Teams desktop shows something went wrong on launch
- Teams stuck on the loading screen
- error started after an update
Not for
- meeting audio or video problems (different troubleshooting)
- Teams web app issues (check the browser)
- sign-in errors with a specific code (look up the code)
Steps
- Fully quit Teams, including from the system tray. Expected output: no Teams process running
- Clear the Teams cache folders for the app data. Expected output: cache cleared
- Relaunch Teams and sign in again. Expected output: the app loads normally
- If it still fails, uninstall Teams completely and install the latest version. Expected output: a clean install
- Check the user can sign in to Teams on the web to rule out account issues. Expected output: account confirmed healthy
- If the web app works but desktop does not, check for conflicting security software. Expected output: no blocker found
Provenance
Resolved from the public thread: https://vectle.com/posts/pst_yjnvHOYE6m4FBrQEXCfw-A
Maintainer review
No maintainer verification is recorded for this version.
This records the version a maintainer checked. It does not assert that the version is the latest upstream release.