Clearing the Microsoft Teams application cache

Overview

Learn how to clear the application cache in Microsoft Teams.

Note: If you're here due to the Try the new Teams toggle not working, please go to the Toggling between Teams classic and the new Teams app article.

Select your operating system to proceed:

Considerations

  • You won't lose any user data by clearing the cache.
  • Restarting Teams after you clear the cache might take longer than usual because the Teams cache files have to be rebuilt.
  • For Windows users: This process will reset any user preferences (i.e., dark mode, etc.).

Clear Teams cache in Windows

Method 1: Reset the app

  1. Type settings in the 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 task bar, 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.

Clear Teams cache in macOS

Follow the steps below:

  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:rm -r ~/Library/Application\ Support/Microsoft/Teamsand then press Return
  4. Restart Teams.

Follow the steps below:

  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 then press Return.
    rm -rf ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams
    rm -rf ~/Library/Containers/com.microsoft.teams2
  4. Restart Teams.

Need Help?

  • For more information, consult the Clear the Teams cache article from Microsoft Learn.
  • For more guidance on this process, please submit a request to the Microsoft Teams Support service page or select the Request Help button on this page.
  • For more information about Microsoft Teams, please consult our Microsoft Teams knowledge base articles.
Create a Ticket Print Article

Related Services / Offerings (1)

Microsoft Teams Support
Microsoft Teams is a communication and collaboration service that is part of Microsoft Office 365.