Teams not loading/crashing

Summary

This guide helps you troubleshoot and resolve: Teams not loading/crashing. Follow the steps below to fix the issue.

Common Causes

Overview

If Microsoft Teams won’t start, freezes, crashes, or gets stuck on the loading screen, try the troubleshooting steps below to get it back up and running.

Quick Fixes

Fix Teams Not Loading

Clear Teams Cache (Windows)

1. Quit Teams completely (right‑click the Teams icon in the taskbar and select Quit).
2. Press Win + R, type %appdata%\Microsoft\Teams and press .
3. Delete the following folders:
   • Application Cache
   • Cache
   • blob_storage
   • databases
   • GPUCache
   • IndexedDB
   • tmp
4. Sign out of Windows or restart the PC to ensure the cache is fully cleared.
5. Launch Teams and sign in again.

Reinstall Teams (Windows)

1. Open Settings → Apps.
   • Windows 10: select Apps & features.
   • Windows 11: select Installed apps.
2. Find Microsoft Teams and click Uninstall. Follow the prompts.
3. Download the latest installer from the official page: Microsoft Teams download.
4. Run the installer and sign in.

Clear Teams Cache (macOS)

1. Quit Microsoft Teams.
2. Open Finder, press Shift + Command + G, and enter ~/Library/Application Support/Microsoft/Teams.
3. Delete the contents of the folder, including the IndexedDB directory.
4. Restart your Mac and launch Teams.

Reinstall Teams (macOS)

1. Open Finder → Applications.
2. Drag Microsoft Teams to the Trash.
3. Download the latest macOS installer from the official page: Microsoft Teams download.
4. Open the downloaded .pkg file and follow the prompts.

Fix Teams Crashing

Update Teams

1. Click your profile picture in Teams.
2. Select Check for updates. Teams will download and install any available updates.
3. Restart Teams.

Run Teams with GPU Acceleration Disabled (Safe Mode)

1. Press Win + R, type teams.exe --disable-gpu (or the full path, e.g., "%LocalAppData%\Microsoft\Teams\current\teams.exe" --disable-gpu) and press .
2. If Teams starts without crashing, the issue is likely GPU‑related. Update your graphics drivers.

Disable Hardware Acceleration

1. Click your profile picture → Settings.
2. Go to the General tab.
3. Toggle Disable hardware acceleration (the wording may appear as “Disable hardware acceleration” or “Turn off GPU hardware acceleration”).
4. Restart Teams.

Check for Windows Updates

Out‑of‑date Windows components can cause Teams to fail. Follow How to update Windows to ensure your system is current.

Network and Firewall Checks

1. Confirm that ports 80, 443, and 3478‑3480 are open on your firewall or proxy.
2. Test connectivity to teams.microsoft.com and login.microsoftonline.com.
3. If you use a corporate VPN, try disconnecting and reconnecting.
4. For broader network troubleshooting, see How to restart router/modem and How to connect to Wi‑Fi.

Specific Issues

Teams Stuck on Loading Screen

1. Clear the Teams cache as described in “Clear Teams Cache (Windows)” or “Clear Teams Cache (macOS)”.
2. Disable hardware acceleration.
3. Ensure you are running the latest Teams version.
4. If the problem persists, reinstall Teams.

Sign‑in Loops

1. Clear cached credentials via the Windows Credential Manager (see note above).
2. Delete the IndexedDB folder in the Teams cache directory.
3. Verify your account password at office.com and confirm multi‑factor authentication is working.
4. Check network connectivity and firewall settings.

Blank Screen After Sign‑in (Desktop)

1. Clear the Teams cache, including IndexedDB.
2. Disable hardware acceleration.
3. Update graphics drivers.
4. If you use a secondary monitor, disconnect it and try launching Teams on the primary display.

Notification Problems

1. In Teams, go to Settings → Notifications and ensure they are enabled.
2. Check Windows notification settings: Settings → System → Notifications & actions → ensure “Microsoft Teams” is allowed.
3. Verify that “Focus assist” is not silencing notifications (Windows security features).
4. Restart Teams after making changes.

Further Assistance

If the problem remains unresolved, please Open a Ticket and include:

• Your device type (Windows or Mac)
• Teams version (click profile → About → Version)
• Any error messages displayed
• Steps you have already tried

Still Having Issues?