Clear Cache Teams Mac: How to Fix It

If Microsoft Teams on your Mac is slow, stuck on a loading screen, or showing stale data, clearing its cache is the fix. You can clear the Teams cache by deleting the contents of the ~/Library/Application Support/Microsoft/Teams folder while Teams is fully quit. This article explains exactly which folders to remove, what happens when you do, and how to avoid common pitfalls.

Why Teams on Mac Needs a Cache

Teams stores temporary files locally to speed up loading—things like avatars, emojis, images, and the code for the app itself. Over time, these files can become corrupted or outdated, causing the app to misbehave. Common symptoms include:

• The app never finishes loading the login screen
• Chat messages fail to send or appear duplicated
• Notifications show old messages or none at all
• The app uses excessive CPU or memory
• Calendar or meeting details are missing or outdated

Clearing the cache forces Teams to rebuild these files from the server, which often resolves these issues. It does not delete your chats, files, or settings—those are stored on Microsoft’s servers.

What Exactly Gets Deleted

The Teams cache folder contains several subfolders and files. When you clear the cache, you are removing:

• Cache – the main storage for media and web content
• Code Cache – compiled JavaScript and other code
• GPUCache – graphics-related temporary data
• blob_storage – binary large objects like images
• databases – local copies of some data (not your actual messages)
• IndexedDB – a local database used by the web-based parts of Teams
• Local Storage – small key-value settings (like window size)
• tmp – temporary files

You do not need to delete the entire Teams folder, only its contents. The app will recreate everything it needs when it restarts.

Step-by-Step: How to Clear Teams Cache on Mac

Follow these steps exactly. Skipping the “quit Teams” step can cause errors.

1. Quit Teams completely. Right-click the Teams icon in the Dock and choose Quit. To be sure it’s not running in the background, open Activity Monitor (in Applications > Utilities), search for “Teams,” and if any process appears, select it and click the X button to force quit.
2. Open Finder. In the menu bar, click Go > Go to Folder (or press Shift+Command+G).
3. Type the path: ~/Library/Application Support/Microsoft/Teams and press Return. (The tilde ~ means your home folder.)
4. Select everything inside. Press Command+A to select all files and folders in that window.
5. Delete. Press Command+Delete or drag the items to the Trash.
6. Empty the Trash. Right-click the Trash icon in the Dock and choose Empty Trash.
7. Restart Teams. Open Teams from the Applications folder or Dock. It will take a bit longer to load the first time, as it rebuilds the cache.

What Happens After You Clear the Cache

When you launch Teams after clearing the cache, you will see the login or loading screen again. The app will download fresh copies of all the temporary files it needs. This means:

• Your sign-in status is preserved (you shouldn’t need to re-enter your password, but if you do, it’s normal).
• Your chat history, files, and teams are all still there—they come from the server.
• Some settings like notification preferences may reset to defaults.
• The first few seconds after launch may be slower than usual, but performance should improve afterwards.

If you are using the new Teams client (version 2.0 or later), the process is slightly different. In the new Teams, you can clear the cache from within the app: click your profile picture > Settings > Appearance and accessibility > scroll down and click Clear cache. This does the same thing without needing to touch Finder.

Common Problems and Their Fixes

Even with the right steps, things can go wrong. Here are the most common issues and how to handle them:

• “The folder is empty” – If you don’t see any files, you might be looking at the wrong folder. Check that you typed the path correctly and that Teams is not running in the background (which would lock the files).
• Teams won’t start after clearing – Restart your Mac and try again. If it still fails, reinstall Teams (see the section below).
• You lose your login – This is rare but happens. Just sign in again with your work or school account.
• Cache clears but problems persist – Try a full reinstall, which removes the entire app and all its data, then installs a fresh copy.

Reinstalling Teams on Mac (When Clearing Cache Isn’t Enough)

If clearing the cache doesn’t fix the issue, a full reinstall is the next step. This removes the app and all its local data, then you download a fresh copy from Microsoft.

1. Quit Teams completely (as described above).
2. Open Finder > Applications, find Microsoft Teams, and drag it to the Trash.
3. Also delete the folder ~/Library/Application Support/Microsoft/Teams (same path as before) and the file ~/Library/Preferences/com.microsoft.teams.plist (you can find it by searching in Finder).
4. Empty the Trash.
5. Download the latest Teams installer from the official Microsoft website (search “Microsoft Teams download” and use the official link).
6. Install and sign in.

This is a more thorough reset and will fix most persistent problems, including corrupted preferences.

How to Prevent Cache Problems in the Future

While you can’t stop Teams from creating a cache, you can reduce the likelihood of corruption:

• Quit Teams properly instead of just closing the window. This lets it flush its cache cleanly.
• Keep your Mac’s storage from filling up – low disk space can cause write errors.
• Update Teams regularly – Microsoft pushes fixes for cache-related bugs in updates.
• If you use the new Teams client, use the built-in “Clear cache” option periodically (every few months) as a preventive measure.

Clearing the cache is a safe, reversible action. It’s one of the first things Microsoft support suggests for Teams issues, and it’s a good habit to know how to do.

Frequently Asked Questions

Will clearing the Teams cache delete my messages?

No. Your messages, files, and team structure are stored on Microsoft’s servers. The cache only contains temporary copies of things like images and code. After clearing, Teams will re-download what it needs, and your conversations will appear normally.

Do I need to log out before clearing the cache?

No, you don’t need to log out. Just quit the app completely (including background processes). If you log out, you’ll have to sign in again, which is extra work but not harmful.

Why does Teams keep coming back after I quit it?

Teams is designed to run in the background for notifications. When you quit via the Dock, it may relaunch automatically. To fully stop it, use Activity Monitor to force quit all processes with “Teams” in the name, or disable the “Auto-start” option in Teams settings.

Does the new Teams client use the same cache folder?

No. The new Teams (version 2.0+) stores its cache in a different location: ~/Library/Application Support/Microsoft/Teams is for the classic client. The new client uses ~/Library/Application Support/Microsoft/Teams (work or school) or similar. The easiest way is to use the in-app “Clear cache” option, which handles the correct folder automatically.

Is it safe to delete the entire Teams folder?

Yes, but you’ll lose your login and all local settings. Deleting the entire folder is effectively the same as a fresh install. If you want to keep your login, delete only the contents of the folder, not the folder itself.

How often should I clear the Teams cache?

Only when you have a problem. There’s no need to do it on a schedule. If you use Teams daily and notice it slowing down, clearing the cache once every few months is a reasonable preventive step, but it’s not required.

Related

• Razer Phone 120 Hz: Which Games Support It?
• How Web Browsers Work: A Developer’s Guide
• AI Module Workload: Can It Scale If Boundaries Hold?