How to clear the Teams client cache


  • If you are experiencing random errors with Microsoft Teams, such as arrow keys not working or unexplained error messages, clearing your cache may be an important first step.
  • This article will help you clear your Microsoft Teams client cache.  Included in the article are instructions for different Operating Systems:

Please note: these instructions assume you are using the desktop version of Teams rather than the browser application. 

Windows OS Instructions 

  1. Fully close Microsoft Teams and Outlook
  2. In Teams, right click the Teams icon in your icon tray in the bottom right corner of your screen, then select Quit.

  3. In Outlook, select the File menu and choose Exit.
  4. While holding the Windows  key, press R to open Windows Run, then copy and paste the following into the box and select OK:

  5. Find the Teams folder, then right click it and select Delete.

  6. Relaunch Microsoft Teams. You should now be prompted to sign back into Teams.

Instructions: macOS

  1. Fully close Microsoft Teams.
  2. Right click the Microsoft Teams icon in your dock, then click Quit.

  3. Open Finder, then click Go and select Go to Folder…

  4. Type the following into the Go to Folder box, then select the top result:


  5. Right click the Teams folder, then click Move to Trash.

  6. Using Spotlight Search (accessed by clicking the magnifying glass on the macOS menu bar), enter “Keychain” and select Keychain Access.
  7. Within Keychain, search for “Microsoft Teams” to find the Microsoft Teams Identities Cache entry. 
  8. Right (two finger) click this item and select the delete option, then close the Keychain Access app.
  9. Relaunch Microsoft Teams. You should now be prompted to sign back into Teams. 


You will be prompted to log back into Teams.  

This should clear your Teams of errors.  


Further Reading

If you are still experiencing issues, please contact the Service Desk. 

Content Credit


Article ID: 1115
Fri 1/14/22 8:36 AM
Wed 1/11/23 9:36 AM