|

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

VersionMethodWhere
New TeamsReset the appSettings > Apps > Installed apps > Microsoft Teams > More options (…) > Advanced options > Reset
New TeamsDelete the files by hand%userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams
Classic TeamsDelete 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 problemDoes Microsoft recommend clearing the cache?
Missing messagesNo
Chat history will not loadNo
A channel or team does not appearNo
Incorrect notifications or unread countsNo
A small local problem with the Teams app itselfIt 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.

  1. Quit Teams from the taskbar and open it again.
  2. Check that Teams is up to date, using the steps further down.
  3. 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

  1. Right-click the Teams icon on the taskbar.
  2. 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.

  1. Type settings in the search box and select the Settings app.
  2. Select Apps > Installed apps, then type Microsoft Teams in the search box.
  3. Find New Microsoft Teams in the results and select the More options button (…).
  4. Select Advanced options.
  5. In the Reset section, select Reset.
  6. 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.

  1. Quit Teams from the taskbar.
  2. Press the Windows logo key + R to open the Run dialog box.
  3. Enter the path below and select OK.
  4. Delete all files and folders in the folder that opens.
  5. 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.

  1. Right-click the Teams icon on the taskbar and select Quit.
  2. Press the Windows logo key + R.
  3. Enter the path below and select OK.
  4. Delete all files and folders in the directory.
  5. 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 pieceWhat 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_8wekyb3d8bbweThe 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

OptionWhat it doesNote from Microsoft
Reset (new Teams)Clears the app data from SettingsAlso deletes personalization settings you configured
Delete files (new Teams)Empties the MSTeams cache folderQuit Teams first
Delete files (classic Teams)Empties the Teams folder in your AppData roaming profileQuit 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 versionFolder Microsoft says to remove
Classic TeamsThe 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

  1. Start Teams again and wait for it to finish loading.
  2. Sign in if Teams asks you to.
  3. 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.

  1. Select Settings and more in Teams.
  2. Select Settings, then About Teams.
  3. 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.

Official sources

Leave a Reply

Your email address will not be published. Required fields are marked *