How to force a refresh/rebuild of Microsoft Teams client cache…

Quick one, if you need to force a refresh or rebuild of the Microsoft Teams client cache on Windows or Mac, do the following:

First choose your Teams client version (old or new):

Teams 2.1 Client (new app)

1. Quit Microsoft Teams
2. Delete or rename the following directory/folder(s):

Windows

%LocalAppData%\Packages\MSTeams_8wekyb3d8bbwe

Mac

/Library/Group Containers/UBF8T346G9.com.microsoft.teams
~/Library/Containers/com.microsoft.teams2

3. Start Microsoft Teams.

The folder you renamed or deleted will be recreated and a fresh cache will be downloaded from the service.

Teams Classic Client (old, original app)

1. Quit Microsoft Teams
2. Delete or rename the following directory/folder:

Windows

%AppData%\Microsoft\Teams\IndexedDB

Mac

~/Library/Application Support/Microsoft/Teams/IndexedDB

3. Start Microsoft Teams.

The folder you renamed or deleted will be recreated and a fresh cache will be downloaded from the service.

The client does this automatically every 24 hours but to speed up certain changes this might help.

So far, I have seen this help the following:

1. Speed up caching delay when moving other users to SfB* coexistence modes.
2. When moving an Islands user from Skype on-prem to Skype online, chat with SfB* coexistence mode users won’t work until the cache is updated.
3. Performance issues of the Teams application

UPDATE (21.05.19): I have been made aware of Mark Vale’s blog post here which clears a lot more cache locations. This covers things like icons, thumbnails, names, local message history, giphys as well as the web client cache. Hope this helps people out too.

UPDATE (01.12.23): I have added the instructions for the new Windows Teams 2.1 client as the cache is held in a different location in the new app.