After upgrading to the new Teams desktop client, you may find that chat messages fail to load. The message list stays blank or shows a spinning icon for a long time. This problem usually appears because the new Teams client uses a different local cache structure and may not migrate the old cache correctly. This article explains the root cause and walks you through the steps to clear the cache, repair the client, and restore your chats.
Key Takeaways: Restore Chat Loading in New Teams
- Teams cache folder %appdata%\Microsoft\Teams: Clearing this folder forces the client to rebuild a fresh cache and often fixes loading failures.
- Teams admin center > Users > Manage users > Policies: Check if a messaging policy is blocking chat history or message retrieval.
- In-app setting Settings > Privacy > Cache: The new Teams has a built-in cache clearing option that avoids manual file deletion.
Why Chat Messages Fail to Load After Switching to New Teams
The new Teams client, built on the WebView2 runtime, stores chat data in a different folder structure than the classic Teams client. When you upgrade, the client attempts to migrate your local cache. If the migration is interrupted or the cache contains corrupted files, the message retrieval process fails. The result is a blank chat list or an infinite loading spinner.
Another common cause is a stale cache from the classic Teams client that is not fully cleared during the upgrade. The new client reads the old cache location and encounters files that are incompatible with its new format. This leads to a failure to load messages even though the server data is intact.
Additionally, the new Teams client may be running with a different user profile or a temporary profile issue after the upgrade. This can happen if the upgrade process does not properly reconfigure the client’s local storage paths.
Steps to Diagnose and Fix Chat Loading Issues in New Teams
Follow these steps in order. After each step, restart Teams and check if messages load. If the issue persists, move to the next step.
- Clear the Teams cache using the in-app setting
Open Teams and go to Settings and more (the ellipsis icon next to your profile picture) > Settings > Privacy > Cache. Click the Clear cache button. This removes the local cache without affecting your data on the server. Restart Teams. - Manually delete the cache folder
Close Teams completely. Right-click the Teams icon in the system tray and choose Exit. Press Ctrl + Shift + Esc to open Task Manager and end any Teams processes. Open File Explorer and paste %appdata%\Microsoft\Teams in the address bar. Delete the contents of this folder, but do not delete the folder itself. Restart Teams and sign in again. - Check the messaging policy in the Teams admin center
If you are an administrator, sign in to the Teams admin center at admin.teams.microsoft.com. Go to Teams admin center > Users > Manage users > Policies. Select the affected user and check the assigned messaging policy. Ensure that the policy does not have the Read receipts or Chat history settings set to Off. If the policy blocks history, change the setting to On and save. - Repair the Teams installation
Open Control Panel > Programs > Programs and Features. Find Microsoft Teams and click Change. Choose Repair and follow the prompts. This reinstalls the client files without deleting your profile. Restart Teams after the repair. - Use the Teams web client as a temporary workaround
If the desktop client still fails, open a browser and go to teams.microsoft.com. Sign in with the same account. If messages load there, the issue is local to the desktop client. This confirms that your data is safe and the problem is cache related.
If Teams Still Has Issues After Clearing the Cache
Teams Shows a Blank Chat Window After Clearing the Cache
Clearing the cache forces Teams to re-sync all conversations from the server. This can take a few minutes depending on the size of your chat history. Wait for the sync to complete. If the window stays blank for more than 15 minutes, close Teams and restart it. If the problem persists, try signing out and signing back in.
Chat Messages Load Only After Multiple Restarts
This pattern usually points to a corrupted cache file that is rebuilt each time. Delete the cache folder again, but this time also delete the folder %appdata%\Microsoft\Teams\Service Worker. This folder contains temporary web worker data that can become corrupted. Restart Teams.
Messages Load on the Web Client but Not on the Desktop Client
If the web client works, the issue is isolated to the desktop installation. Uninstall Teams completely using Control Panel or Settings > Apps > Installed apps. Then reinstall the latest version from the Microsoft 365 download page. After reinstall, sign in and check if messages load.
New Teams Desktop vs Teams on the Web: Key Differences
| Item | New Teams Desktop | Teams on the Web |
|---|---|---|
| Cache location | Local folder %appdata%\Microsoft\Teams | Browser cache and IndexedDB |
| Offline access | Supports offline mode for some features | Requires an active internet connection |
| Performance | Uses system resources more efficiently after warm-up | Depends on browser performance and memory |
| Notification support | Native system notifications with sound options | Browser notifications, may be delayed |
After clearing the cache and repairing the client, your chat messages should load normally. If the issue persists, verify that your messaging policy allows chat history. You can also try the web client as a reliable fallback. For a faster experience, pin the chat view to your left rail and use the Ctrl + 2 shortcut to jump directly to chats.