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.

Windows

1. Quit (completely exit) Teams and Outlook. Make sure they are not still visible in the system tray.
2. Open File Explorer
   
3. Open the Teams AppData folder: Enter %AppData%\Microsoft\Teams\ in the address bar, and press Enter
   
4. Delete all the contents of the Teams AppData folder
5. Re-open Teams and Outlook

macOS

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