Teams Troubleshooting - Clearing the Cache

Tags teams

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

Print Article