MS Teams: Clearing Cache in Microsoft Teams

Summary

This article describes how to purge the Teams cache in both the Windows and Mac installed app. Sometimes you need to purge the contents of your cache to increase the speed of the application allowing the application to function properly.

Body

Summary

This article explains how to clear the Teams cache for both the Windows and Mac versions of the app. Clearing your cache can help improve the app's speed and ensure it works correctly.

Note: USNH has deployed New Teams exclusively and this article provides instructions for USNH managed devices using the New Teams version of the app. If you are on a non-managed or personal computer and are using Classic Teams, view instructions for clearing classic Teams cache here: Clear the Teams Client Cache

Content

To clear your Microsoft Teams cache, delete temporary and saved files from your computer using the instructions provided.  

Clearing the Microsoft Teams cache can solve many problems and improve overall performance. Understanding why you should do it can help you keep Teams running smoothly.

Common Issues Caused by Cache Build-Up:

  1. Slow Performance: Over time, cache files accumulate and can slow down the app's performance.
  2. Outdated Information: Stored cache might cause Teams to display old user profile pictures or outdated data.
  3. Login Issues: Cache build-up can sometimes prevent you from logging in or cause repeated sign-in prompts.
  4. Crashes and Freezes: Excessive cache can make the app unstable, leading to frequent crashes and freezes.

Follow the link to the task you want to achieve:

How-To

Task: To clear your Windows Teams cache.

 

Method 1: Reset the App

 
When you reset the Teams app, the app data will be deleted. This includes any personalization settings that you might have configured.

  1. Type settings in your Windows search box, and then select the Settings app from the results.
  2. Select Apps > Installed apps, and then type Microsoft Teams in the search box.
  3. Locate the New Microsoft Teams app from the results, select the More options button (...) on the right, and then select Advanced options.
  4. In the Reset section, select Reset.
  5. Restart Teams.
     

Method 2: Delete the Files

 
  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:
    %userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams
  4. Delete all files and folders in the directory.
  5. Restart Teams.

Outcome

Your Windows Microsoft Teams chat cache is deleted.

Back to top

 

Task: To clear your Mac Teams cache.

 
Instructions

  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 commands, and press Return after each command:

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

 

Outcome

Your MacOS Microsoft Teams cache is deleted.

Back to top​​​​​​​

 

Need additional help?

For assistance concerning site creation, content sharing, file synchronization, or other common SharePoint, OneDrive, Teams, or Office app activities, we recommend our Microsoft 365 Learning sites:

Learn more about the great tools our Microsoft 365 Learning sites offer!

Visit the Technology Help Desk Support page to locate your local campus contact information or to submit an online technology support request.  For password issues you must call or visit the Help Desk in person.  

Details

Details

Article ID: 2197
Created
Tue 3/24/20 10:05 AM
Modified
Mon 6/2/25 4:52 PM
Applicable Institution(s):
Keene State College (KSC)
Plymouth State University (PSU)
University of New Hampshire (UNH)
USNH System Office