1. Home
  2. Remote Instruction
  3. Microsoft Teams
  4. Microsoft Teams – Clearing the Teams Client Cache
  1. Home
  2. Remote Instruction
  3. Microsoft Teams – Clearing the Teams Client Cache

Microsoft Teams – Clearing the Teams Client Cache

If you’re experiencing issues with your Microsoft Teams client, clearing the cache may help.

Using Linux?

Microsoft Teams is available on Linux operating systems, but the cache clear procedure will vary widely. Try searching for “Teams clear cache” along with your OS distribution.

macOS (Classic Teams)

  1. Fully close Microsoft Teams.
    1. Right click the Microsoft Teams icon in your dock, then click Quit.
  2. Open Finder, then click Go and select Go to Folder…
  3. Copy and paste the following into the Go to Folder box, then click Go:
    ~/Library/Application Support/Microsoft

  4. Right- or control-click the Teams folder and click Move to Trash.
  5. Using Spotlight Search (accessed by clicking the magnifying glass on the macOS menu bar), enter “Keychain” and select Keychain Access.

    macOS Spotlight search for Keychain
  6. Within Keychain, search for “Microsoft Teams” to find the Microsoft Teams Identities Cache entry. Right- or control-click this item and select the Delete option, then close the Keychain Access app.
    Searching for Microsoft Teams keys in keychain
  7. Relaunch Microsoft Teams. You should now be prompted to sign back in, as shown in this article.

macOS Finder (New Teams)

  1. If Teams is running, Quit the application. One way to do this is to is to right- or control-click the Teams icon in the dock, and select Quit. Do the same for Outlook.
    macOS Dock apps context menus with Quit highlighted
  2. Select the Finder app or click the Desktop background.
    Finder for macOS app icon
  3. Open the Go to Folder window. One way to do this is to click Go at the top of the screen and then select Go to folder….
    macOS Finder Go menu with Go to Folder highlighted
  4. Copy and Paste the following line of text into the box that appears and hit Return.
    ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams
  5. Move the contents of the folder to the Trash. One way to do this is to select all with controlA, right- or control-click one of the items, and then select Move to Trash.
    Finder for macOS context menu with Move to Trash highlighted
  6. Repeat steps 3-5 above deleting the items from the following folder instead:
    ~/Library/Containers/com.microsoft.teams2
  7. Relaunch Microsoft Teams.

macOS Terminal (New Teams)

  1. If Teams is running, Quit the application. One way to do this is to is to right- or control-click the Teams icon in the dock, and select Quit. Do the same for Outlook.
    macOS Dock apps context menus with Quit highlighted
  2. Open the Terminal app. One way to do this is to hold down the Command key and tap the Space bar (CommandSpace bar), type “terminal” into the Spotlight search field, and then hit Return.
    macOS Spotlight search for terminal
  3. Copy and paste the following lines of text into the Terminal window one at a time, pressing Return after each command.
    rm -rf ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams
    rm -rf ~/Library/Containers/com.microsoft.teams2
    
  4. Relaunch Microsoft Teams.

macOS Finder (New Teams): Advanced

  1. If Teams is running, Quit the application. One way to do this is to is to right- or control-click the Teams icon in the dock, and select Quit. Do the same for Outlook.
    macOS Dock apps context menus with Quit highlighted
  2. Select the Finder app or click the Desktop background.
    Finder for macOS app icon
  3. Open the Go to Folder window. One way to do this is to click Go at the top of the screen and then select Go to folder….
    macOS Finder Go menu with Go to Folder highlighted
  4. Copy and Paste the following line of text into the box that appears and hit Return.
    ~/Library/Group Containers/
  5. Move the following folder to the trash.
    UBF8T346G9.com.microsoft.teams
  6. Now navigate to the following folder.
    ~/Library/Containers/
  7. Move the following folders to the trash.
    Microsoft Teams (work or school)
    com.microsoft.teams2.respawn
  8. Open Keychain Access.
  9. From the login tab, delete the line item containing the word “oneauth“.
  10. From the Local Items tab, delete the line item at the top (alphabetically) whose name is just letters and numbers.
    1c177758-4d6b-43dc-aaeb-3b9c42562967
  11. Relaunch Microsoft Teams and sign back in.

macOS Terminal (New Teams): Advanced

  1. If Teams is running, Quit the application. One way to do this is to is to right- or control-click the Teams icon in the dock, and select Quit. Do the same for Outlook.
    macOS Dock apps context menus with Quit highlighted
  2. Open the System Settings app and select the Privacy & Security tab.
  3. Under the Privacy heading, click Full Disk Access.
  4. If not on already, click to turn on the toggle switch to the right of Terminal.
  5. Open the Terminal app. One way to do this is to hold down the Command key and tap the Space bar (CommandSpace bar), type “terminal” into the Spotlight search field, and then hit Return.
    macOS Spotlight search for terminal
  6. Copy and paste the following lines of text into the Terminal window one at a time, pressing Return after each command.
    rm -rf ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams
    rm -rf ~/Library/Containers/com.microsoft.teams2
    rm -rf ~/Library/Containers/com.microsoft.teams2.respawn
    security delete-generic-password -s OneAuthAccount
    open -a Keychain\ Access
  7. From the Keychain Access window, select the Local Items tab.
  8. Delete the line item at the top (alphabetically) whose name is just letters and numbers.
    1c177758-4d6b-43dc-aaeb-3b9c42562967
  9. Relaunch Microsoft Teams.

Windows (Classic Teams)

  1. If open, close Microsoft Teams and Outlook.
    1. Right click the Teams icon in your icon tray in the bottom right corner of your screen, then click Quit.
    2. In Outlook, select the File menu and choose Exit.
  2. Open the Windows Run dialog box. One way to do this is to hold down the Windows key on your keyboard and tap R ( + R).
  3. In the Run dialog box, copy and paste the following line of text and click OK.
    %appdata%\Microsoft\Teams

    Windows Run window with Teams cache folder path

  4. Delete all files and folders in the folder that appears. One way to do this is to use Ctrl + A to select all files, and then tap the Delete key.
  5. Relaunch Microsoft Teams. You should now be prompted to sign back in, as shown in this article.

Windows (New Teams)

Method 1: Reset the app

  1. Open the Windows Settings app. One was to do this is to tap the Windows () key on your keyboard, type “settings”, and then hit Enter.
    Windows 11 Search for settings
  2. Navigate to the Apps > Installed apps section of Settings. One way to do this is to use the search bar to search for “installed apps”, and then click on the result.
    Windows 11 Settings Search for installed apps
  3. Locate Microsoft Teams (work or school) from the results or again use the search bar to find it, click the three dots () to the right, and then select Advanced options.
    New Teams ellipse menu with Advanced options highlighted
  4. Scroll down to find the Reset section, and click Reset.
    Windows 11 Settings app Reset button
  5. Relaunch Microsoft Teams (work or school).

Method 2: Delete the files

  1. If Teams is still running, Quit the app. One way to do this is to find the Teams icon in the “tray” in the bottom-right corner of the screen (You may have to click the up caret  to show hidden icons first), right-click on it, and select Quit.
    Windows app tray Teams icon context menu with Quit highlighted
  2. Open the Windows Run dialog box. One way to do this is to hold down the Windows key on your keyboard and tap R ( + R).
  3. In the Run dialog box, copy and paste the following line of text and click OK.
    %userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams

    Windows Run dialog with New Teams cache folder path

  4. Delete all files and folders in the folder that appears. One way to do this is to use Ctrl + A to select all files, and then tap the Delete key.
  5. Relaunch Microsoft Teams (work or school).

Updated on April 5, 2024

Related Articles

Not the solution you were looking for?
Don’t worry we’re here to help!
Submit a Help Ticket