Teams Troubleshooting - Clearing the Cache

Instructions for manually clearing Teams desktop app cache in Windows, macOS and Linux

If the Teams desktop application starts misbehaving (missing messages, errors, etc) a cache clear can often help.

Reference: https://learn.microsoft.com/en-us/troubleshoot/microsoftteams/teams-administration/clear-teams-cache

Windows

New Teams

1. If Teams is still running, right-click the Teams icon on the taskbar, and then select Quit.
2. Open the Run dialog box by pressing the Windows logo key +R.
3. In the Run dialog box, enter the following path, and then select OK.

   1. %userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams

4. Delete all files and folders in the directory.
5. Restart Teams.

Classic Teams

1. Quit (completely exit) Teams and Outlook. Make sure they are not still visible in the system tray.
2. Open the Run dialog box by pressing the Windows logo key +R.
3. In the Run dialog box, enter the following path, and then select OK.

   1. %AppData%\Microsoft\Teams\

4. Delete all files and folders in the directory.
5. Restart Teams and Outlook

macOS

New Teams

1. If Teams is still running, right-click the Teams icon in the dock, and then select Quit or press Command (⌘)-Q.
2. In the Finder, open the /Applications/Utilities folder, and then double-click Terminal.
3. Enter the following command, and then press Return:

   1. rm -r ~/Library/Application\ Support/Microsoft/Teams

4. Restart Teams.

Classic Teams

1. Right-click the Microsoft Teams icon in your dock, then select Quit
2. Open Finder and select Go > Go to Folder
3. Copy and paste the following into the Go to Folder box, then select Go
   ~/Library/Application Support/Microsoft
4. Right-click on the Teams folder and select Move to Trash
5. Click the magnifying glass in the upper-right corner of the screen to open Spotlight Search
6. Enter 'keychain' in the search bar and select Keychain Access in the search results
7. Within Keychain Access, search for 'Microsoft Teams' and locate the "Microsoft Teams Identities Cache" entry
8. Right-click and select the option to Delete the entry
9. Close Keychain Access
10. Relaunch Microsoft Teams. You may be prompted for sign-in credentials.

Linux

https://gist.github.com/mrcomoraes/c83a2745ef8b73f9530f2ec0433772b7