How to clear the Teams client cache

Overview

  • 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 

  • Fully close Microsoft Teams and Outlook by right-clicking its icon on the Taskbar and selecting Quit. 

 

 

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

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

  • While holding he Ctrl key, press A to select everything in the folder then right click it and select Delete.



 

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

Instructions: macOS

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



 

  • Open Finder, go to Applications, Utilities, and open Terminal.
  • Copy and paste the following commands, pressing Return after each one:

rm -rf ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams

rm -rf ~/Library/Containers/com.microsoft.teams2

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

 

Outcome 

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

Print Article