Why is Microsoft Teams running slow today? If you’ve ever stared at a spinning wheel while waiting for a message to send, you know that frustration well. Laggy video, frozen chat windows, and high CPU usage are classic signs that corrupted cache files are bogging down your app performance. The good news is that learning how to clear cache for Teams is a quick, safe fix that restores smooth system resource usage without deleting a single one of your chat histories or files.
In this guide, we’ll walk through exactly how to purge the temporary data that causes these glitches on Windows, Mac, iOS, Android, and in your web browser. We’ll also look at version differences—because the path for Classic Teams is quite different from the New Microsoft Teams (UWP)—so you can apply the right fix for your specific setup.
Before You Start: Is Clearing Cache the Right Move?
Before you dive into folder structures and terminal commands, it’s worth a pause. Teams app troubleshooting isn’t just about wiping everything out. Clearing the cache is a targeted tool, not a magic wand for every possible issue.
Symptoms Indicating a Cache Issue
How do you know if the cache is actually the culprit? In my experience handling user support tickets, I’ve found that specific behavioral patterns point directly to local data corruption. If your computer’s Task Manager (or Activity Monitor on Mac) shows system resource usage spiking to 80-100% CPU while Teams is idle, that’s a major red flag.
Other clear indicators include:
- Black screens or failed video loading: The chat loads, but video calls stay stuck on the camera preview or turn into a black square.
- App crashes or won't open: The app launches, shows a splash screen, and then immediately closes or hangs.
- Sync errors: Channels appear empty until you refresh manually, or unread badges remain stuck.
I’ve seen instances where a user’s Teams folder ballooned to several gigabytes simply because temporary meeting recordings and media previews weren’t purging correctly.
When NOT to Clear Your Cache
It is crucial to understand the limits of this fix. Microsoft explicitly warns that clearing the cache does not fix issues with missing messages, channel sync problems, or incorrect notification counts. More importantly, the cache contains diagnostic logs that IT support teams need to identify the root cause of deeper synchronization errors. If you clear them before opening a support ticket, you lose that evidence.
If your issue is minor, try a softer first step: sign out and in. This refreshes your authentication token and resets the local session state without destroying the underlying local data store. If that doesn’t work, then proceed to a full cache clear.
How to Delete Microsoft Teams Cache on Windows
Windows users have two main versions of the app to deal with: the legacy "Classic" Teams and the "New" Microsoft Teams, which uses the Universal Windows Platform (UWP). The file paths for delete microsoft teams cache windows operations differ significantly between the two.
Method 1: Classic Teams (Legacy)
If you are still using the older desktop application, the cache is stored in the AppData folder, which is hidden by default.
- Quit the app completely. Right-click the Teams icon on your taskbar and select Quit. Just closing the window isn't enough; the process must stop to release the file locks.
- Open the Run dialog. Press
Windows Key + Ron your keyboard. - Navigate to the cache folder. Type
%appdata%\Microsoft\Teamsinto the box and hit Enter. - Delete the contents. In the window that opens, select all files and folders (Ctrl+A) and delete them.
- Restart Teams. Relaunch the app. The first startup will be slower than usual as the app rebuilds its necessary local files.
Method 2: New Microsoft Teams (UWP)
The New Teams app is packaged as a UWP application, which means it stores data in a protected container. You have two options here.
Option A: Reset via Windows Settings (Easiest) This method is safe and recommended for most users. Note that this will delete personalization settings like your theme or display preferences.
- Press
Windows Key + Ito open Settings. - Go to Apps > Installed apps.
- Search for Microsoft Teams and click the three dots (...) next to it, then select Advanced options.
- Scroll down to the Reset section and click Reset.
Option B: Manual Deletion (For Stubborn Issues) If the reset didn't work, you can manually access the UWP cache folder.
- Quit Teams as described above.
- Press
Windows Key + Rand paste the following path:%userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams - Delete all files inside this directory.
- Restart the application.
I’ve found that Option B is particularly effective when the "Reset" button seems to fail due to permission errors or if the app is stuck in a corrupted installation state.
Clearing Cache on Mac and Mobile Devices
Mac users have a more direct approach using the Terminal, while mobile users face stricter OS limitations.
macOS: Terminal Commands for Classic and New Teams
On macOS, cache folders are located in the hidden Library folder. Using Terminal commands is the most thorough way to ensure no residual files remain.
For Classic Teams:
-
Quit Teams by pressing
Command + Q. -
Open Terminal (found in Applications > Utilities).
-
Type the following command and press Return:
rm -r ~/Library/Application\ Support/Microsoft/Teams -
Restart Teams.
For New Teams: The New Teams app on Mac uses a different container structure.
-
Quit Teams (
Command + Q). -
Open Terminal and execute these two commands, pressing Return after each:
rm -rf ~/Library/Group\ Containers/UBF8T346G9.com.microsoft.teams rm -rf ~/Library/Containers/com.microsoft.teams2 -
Restart the app.
iOS and Android: App-Specific Limitations
Mobile operating systems sandbox apps for security, meaning you can’t just browse a file system and delete specific cache files like on a desktop. However, you can still clear temporary memory and, in some cases, the app's storage.
For Android (clear cache on android teams): Android offers a built-in utility for this.
- Go to Settings > Apps > Microsoft Teams.
- Tap Storage.
- Tap Clear Cache. This removes temporary files without deleting your login or chat history.
- If the issue persists, you can try Clear Data, but be aware this logs you out and may delete locally stored files.
For iPhone (iOS): iOS does not have a "Clear Cache" button for individual apps. The only reliable methods are:
- Force Restart the Phone: This clears the RAM where temporary active processes live. Hold the side button and volume up, slide to power off, then turn it back on.
- Delete and Reinstall: This is the "ultimate reset." Open Settings > General > iPhone Storage, find Teams, and tap Remove App > Delete App. Then reinstall from the App Store. This ensures all bundled cache data is wiped clean.
Browser-Based Teams: Managing Web Cache
If you access Teams via Chrome, Edge, or Firefox, the issues often stem from the browser's temporary internet files or conflicting extensions.
Chrome, Edge, and Firefox Steps
- Clear Site Data: Instead of clearing your entire browser history, target just the Teams domain.
- Chrome/Edge: Click the lock icon in the address bar > Site Settings > Clear data for this site.
- Firefox: Click the shield icon in the address bar > Clear site data.
- Check for Extension Conflicts: Browser extension conflicts can mimic cache issues. Disable ad-blockers or privacy extensions one by one to see if one is blocking Teams' resources. I’ve seen Malwarebytes and various ad-blockers aggressively block Teams' telemetry endpoints, causing severe lag.
- Hard Refresh: After clearing, don't just reload the page. Use a hard refresh to force the browser to bypass the cache entirely:
- Windows/Linux:
Ctrl + Shift + R - Mac:
Cmd + Shift + R
- Windows/Linux:
What If Teams Is Still Slow After Clearing Cache?
If fix slow microsoft teams attempts via cache clearing haven't worked, the problem likely lies deeper in your hardware configuration or account settings.
Advanced Troubleshooting & Data Recovery
- Check Hardware Acceleration: Sometimes, GPU drivers conflict with Teams' video processing. Go to Teams Settings > General (or Preferences on Mac) and toggle off Use hardware acceleration for rendering. This can resolve screen flickering and crashes.
- Review System Resource Usage: Ensure your computer meets the minimum requirements. Teams is a heavy application; on a machine with only 4GB of RAM, it will struggle even with a clean cache.
- Reinstall Application: As a last resort on desktop, uninstall and reinstall the Teams client. This repairs corrupted system files that cache clearing cannot touch.
- Contact IT Support: If the issue is specific to your account or organization, it may be a server-side sync issue. Your IT team can review the diagnostic logs (if you haven't cleared them yet) to identify the root cause.
Frequently Asked Questions
Does clearing Teams cache delete my chat history? No. This is a common fear, but it is unfounded. The cache consists of temporary files, diagnostic logs, and cached media previews. Your actual chat history, files, and conversations are stored in the cloud (Microsoft 365). Clearing the local cache does not trigger any data recovery or deletion of user content. You will remain logged in and your history will be intact when you restart the app.
How do I clear cache on iPhone specifically? Because iOS restricts direct file system access, you cannot browse to a cache folder. The most effective method is to delete the Teams app from your phone and reinstall it. This removes all locally stored temporary data. Alternatively, a force restart of the device clears the RAM cache, which may resolve minor performance hiccups.
What is the difference between Classic and New Teams cache paths? The paths differ because the apps use different underlying technologies.
- Classic Teams:
%appdata%\Microsoft\Teams - New Teams (UWP):
%userprofile%\appdata\local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeamsThe New Teams app is a Universal Windows Platform application, so its files are stored in a protected package directory structure rather than the traditional AppData folder.
Why is Teams taking up so much storage even after clearing cache? Clearing the cache only removes temporary files. Large storage usage is often caused by downloaded meeting recordings, locally saved files, or media libraries that are stored separately from the cache. To free up significant space, you may need to manually delete local recordings or change your download settings in Teams preferences.
Conclusion
Learning how to clear cache for Teams is one of the most effective, low-risk steps you can take to boost your app performance. It’s a safe first move for performance issues, and it usually resolves freezing, lag, and video glitches without any data loss.
However, if the problem persists after clearing the cache, remember that the issue might be related to hardware limitations or account-specific sync errors. Keeping your Teams application up to date is the best way to prevent corrupted cache files from accumulating in the first place.
Try these steps now to get your workflow back on track. Still facing persistent issues? Subscribe to our newsletter for more advanced Microsoft 365 troubleshooting tips and deeper dives into productivity tools.