DEV Community

Bryz︱🦾
Bryz︱🦾

Posted on

🔄 Teams Acting Weird? Clear the Cache Before You Reinstall

"Teams won't load." "My messages aren't showing up." "It's stuck on a white screen." 😩

If you work help desk, Microsoft Teams tickets are a daily thing. The tempting move is to uninstall and reinstall. But most of the time, the real problem is a corrupted local cache, and you can fix it in about a minute. 🚀

🤔 Why the cache?

Teams stores a lot of data locally to load faster: settings, images, tokens, and more. When that data gets stale or corrupted, you get weird symptoms like endless loading, missing messages, blank screens, or sign-in loops.

Clearing the cache forces Teams to rebuild it fresh. Your chats, channels, and files live in Microsoft 365, so they come right back. ✅

1️⃣ Fully quit Teams

Closing the window just minimizes Teams to the system tray. Right-click the Teams icon in the taskbar (or the tray) and choose Quit.

Want to be sure it's really closed? Run this in PowerShell:

Get-Process ms-teams -ErrorAction SilentlyContinue | Stop-Process -Force
Enter fullscreen mode Exit fullscreen mode

(ms-teams is the process name for the new Teams app.)

2️⃣ Clear the cache

Option A: the click-through way 🖱️

Go to Settings > Apps > Installed apps, find Microsoft Teams, click the ... menu, choose Advanced options, then click Reset.

Option B: the folder way 🧹

Press Win + R and paste:

%localappdata%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams
Enter fullscreen mode Exit fullscreen mode

Delete everything inside that folder (not the folder above it).

Or do it in one shot from PowerShell:

Remove-Item "$env:LOCALAPPDATA\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\*" -Recurse -Force
Enter fullscreen mode Exit fullscreen mode

🖼️ Heads up: uploaded custom backgrounds are stored in that folder too. If the user cares about them, copy the Backgrounds folder somewhere safe first.

📝 Still on classic Teams? The cache lives in %appdata%\Microsoft\Teams instead.

3️⃣ Reopen and sign in

Launch Teams again. The first load takes a little longer while it rebuilds. The user may need to sign in again, and some app settings may reset to default.

Then check the original symptom. Messages showing? Loading normally? 🎉

🎯 When the cache isn't it

If Teams is still broken after a clean cache:

  • 🌐 Check Service health in the Microsoft 365 admin center for a Teams outage
  • 👤 Try Teams on the web or another device. If it fails there too, it's the account, not the PC
  • 🔄 Make sure Windows and Teams are up to date

Only then is a reinstall worth your time.

✅ Why this matters

A cache clear is fast, safe, and fixes a huge share of Teams tickets. Learning to try the small, reversible fix first makes you faster and saves the user from a long, frustrating reinstall.

What's your go-to fix when Teams starts misbehaving? Drop it in the comments 👇

Top comments (0)