How To Clear The Teams Cache On Windows (2026)
You want to clear the Teams cache on Windows because the app is acting up.
The steps differ for new Teams and classic Teams, and Microsoft warns that clearing the cache is the wrong fix for some problems.
Check the warning first, then use the method that matches your version.
Quick answer: clear the Teams cache on Windows
| Version | Method | Where |
|---|---|---|
| New Teams | Reset the app | Settings > Apps > Installed apps > Microsoft Teams > More options (…) > Advanced options > Reset |
| New Teams | Delete the files by hand | %userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams |
| Classic Teams | Delete the files by hand | %appdata%\Microsoft\Teams |
These steps come from Microsoft’s Teams page on clearing the client cache.
When you should not clear the cache
Microsoft does not recommend clearing the cache for problems with Teams chats or channels.
That covers missing messages, chat history that will not load, a channel or team that does not appear, and wrong notifications or unread counts.
Microsoft says clearing the cache does not fix those issues and deletes the diagnostic logs that are needed to find the cause.
It describes cache clearing as a targeted step for a small number of local client problems, not a general first step.
Use this list to decide whether a cache clear is worth your time.
| Your problem | Does Microsoft recommend clearing the cache? |
|---|---|
| Missing messages | No |
| Chat history will not load | No |
| A channel or team does not appear | No |
| Incorrect notifications or unread counts | No |
| A small local problem with the Teams app itself | It is the kind of problem the page treats as a target for cache clearing |
Before you start
- Quit Teams completely before you delete any files.
- Expect the next start to take longer than usual, because Teams rebuilds the cache files.
- Know which version you use, because new Teams and classic Teams store their data in different places.
A sensible order to try things
Because the cache clear removes logs and takes longer to restart, try the lighter steps first.
- Quit Teams from the taskbar and open it again.
- Check that Teams is up to date, using the steps further down.
- Clear the cache only if the problem is a local app problem and not a chat, channel or notification problem.
Microsoft’s page itself says to restart Teams after clearing, and it warns that the restart may take longer than usual.
Quit Teams first
- Right-click the Teams icon on the taskbar.
- Select Quit.
This applies to both versions, and Microsoft lists it as a prerequisite for deleting files by hand.
New Teams: reset the app
Resetting is the simplest route for new Teams because you stay inside Windows Settings.
- Type settings in the search box and select the Settings app.
- Select Apps > Installed apps, then type Microsoft Teams in the search box.
- Find New Microsoft Teams in the results and select the More options button (…).
- Select Advanced options.
- In the Reset section, select Reset.
- Restart Teams.
Microsoft notes that a reset deletes the app data, including any personalization settings you configured.
New Teams: delete the cache files by hand
If you would rather not reset the app, you can empty the cache folder yourself.
- Quit Teams from the taskbar.
- Press the Windows logo key + R to open the Run dialog box.
- Enter the path below and select OK.
- Delete all files and folders in the folder that opens.
- Restart Teams.
%userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams
Classic Teams: delete the cache files
Classic Teams has no reset button in Microsoft’s steps, so you clear it by hand.
- Right-click the Teams icon on the taskbar and select Quit.
- Press the Windows logo key + R.
- Enter the path below and select OK.
- Delete all files and folders in the directory.
- Restart Teams.
%appdata%\Microsoft\Teams
Reading the folder paths
The Run box understands the short variables in these paths, so you can paste them exactly as written.
| Path piece | What it points to |
|---|---|
| %appdata% | Your Windows roaming app data folder, used here by classic Teams |
| %userprofile% | Your Windows user folder, the starting point for the new Teams path |
| MSTeams_8wekyb3d8bbwe | The package folder name Microsoft gives for new Teams |
If the folder does not open, check that you copied the whole path and that Teams is not running.
Reset or delete: what is different
| Option | What it does | Note from Microsoft |
|---|---|---|
| Reset (new Teams) | Clears the app data from Settings | Also deletes personalization settings you configured |
| Delete files (new Teams) | Empties the MSTeams cache folder | Quit Teams first |
| Delete files (classic Teams) | Empties the Teams folder in your AppData roaming profile | Quit Teams first |
Microsoft’s page does not describe a separate repair option, only the reset for new Teams.
If you are on a Mac
Microsoft gives separate Terminal steps for Mac, and they remove folders from your Library.
| Mac version | Folder Microsoft says to remove |
|---|---|
| Classic Teams | The Teams folder inside Application Support in your Library |
| New Teams (folder 1) | The UBF8T346G9.com.microsoft.teams folder inside Group Containers |
| New Teams (folder 2) | The com.microsoft.teams2 folder inside Containers |
Microsoft says to quit Teams first, either from the Dock or with Command-Q.
Follow Microsoft’s own page for the exact commands, because a typing mistake in Terminal can delete the wrong folder.
After you clear the cache
- Start Teams again and wait for it to finish loading.
- Sign in if Teams asks you to.
- Check whether the original problem is gone.
If you reset new Teams, expect to set your personalization options again.
Check that Teams is up to date
An out-of-date app is a common reason to try a cache clear, so check the version too.
- Select Settings and more in Teams.
- Select Settings, then About Teams.
- Look under Version to see whether you have the latest version or need to update.
Microsoft says a notice appears at the top of the Teams window when an update is available, and you can select Update and restart Teams from the more options menu.
If you do nothing, Microsoft says Teams updates itself when an update is available and the app is idle.
Better fixes for specific Teams problems
Because Microsoft advises against clearing the cache for chat and notification problems, use a fix aimed at the actual symptom.
- Teams stuck loading or not opening
- Teams notifications not working
- Microphone or camera not working in Teams