sodcalculator

10 Tech How-To

Fix Teams Disconnected Error: Step-by-Step Guide

Guide 10-45999 · Updated · Step by step

Microsoft Teams showing a “disconnected” error means your client has lost its connection to the Teams servers, so messages won’t send, calls drop, and status shows as offline. This guide walks through the most common fixes, from a simple restart to clearing cached data, so you can get back online quickly.

What You’ll Need

  • Access to your computer or mobile device where Teams is installed
  • Your Microsoft 365 or Teams login credentials (in case you need to sign back in)
  • Administrator rights on your computer (for some steps like clearing cache or reinstalling)
  • A stable internet connection (Wi-Fi or Ethernet)

Step-by-Step

  1. Check your internet connection. Open a web browser and visit a site like example.com. If the page doesn’t load, restart your router or modem by unplugging them for 30 seconds, then plugging them back in. Wait for the lights to stabilize before moving on.
  2. Restart the Teams app. Right-click the Teams icon in the system tray (bottom-right corner on Windows, top-right on Mac) and select Quit or Exit. Then reopen Teams from the Start menu or Applications folder. This clears minor glitches that cause the disconnected banner.
  3. Sign out and sign back in. Click your profile picture at the top-right of Teams, choose Sign out, and close the app. Reopen Teams, sign in with your credentials, and check if the connection restores.
  4. Update Teams. Click your profile picture, then select Check for updates. Teams will download and install any pending updates automatically. After updating, restart the app.
  5. Clear the Teams cache. Close Teams completely (right-click the tray icon and choose Quit). Press Windows + R to open the Run dialog, type %appdata%\Microsoft\Teams and press Enter. Delete all files and folders inside this directory (you can select all and press Delete). Reopen Teams—it will rebuild the cache and reconnect.
  6. Check your system date and time. Teams requires accurate time settings to authenticate. On Windows, go to Settings > Time & Language > Date & time and toggle Set time automatically and Set time zone automatically on. On Mac, go to System Preferences > Date & Time and enable automatic setting.
  7. Disable VPN or proxy. If you use a VPN, temporarily turn it off and try Teams again. For proxy settings, go to Windows Settings > Network & Internet > Proxy and turn off Use a proxy server (or Mac System Preferences > Network > Advanced > Proxies). Reconnect after changing these.
  8. Check firewall or antivirus settings. Ensure Teams is allowed through Windows Defender Firewall. Go to Control Panel > System and Security > Windows Defender Firewall > Allow an app through the firewall. Find Teams and ensure both Private and Public boxes are checked. If you use third-party antivirus, add Teams as an exception.
  9. Reinstall Teams. Uninstall Teams from Settings > Apps > Apps & features (Windows) or drag it to Trash (Mac). Download the latest installer from the official Microsoft website and install it fresh. Sign in again.
  10. Use the web version as a temporary workaround. If the desktop app still shows disconnected, open a browser, go to teams.microsoft.com, and sign in. This confirms whether the issue is app-specific or network-wide.

Common Mistakes

  • Not fully quitting Teams before clearing cache. If Teams is still running in the background, the cache files are locked and deletion fails. Always right-click the tray icon and select Quit, then check Task Manager (Ctrl+Shift+Esc) for any Teams processes and end them.
  • Skipping the internet check. Many users assume Teams is the problem when the entire network is down. Always verify basic web browsing first.
  • Leaving VPN on. Corporate VPNs often block Teams’ connection ports. Even if other apps work, Teams can fail specifically due to VPN routing.
  • Deleting the wrong folder. The cache path is %appdata%\Microsoft\Teams (not the installation folder under Program Files). Deleting the program folder breaks the installation entirely.
  • Ignoring date/time sync. An incorrect system clock causes authentication failures that appear as “disconnected.” This is easy to overlook but very common.

Tips

  • Use a wired connection. If you’re on Wi-Fi, plugging in an Ethernet cable often stabilizes the connection and reduces disconnects.
  • Keep Teams updated. Microsoft regularly releases fixes for connectivity bugs. Enable automatic updates in Teams settings.
  • Restart your computer. A full reboot clears network stacks and background processes that might interfere with Teams.
  • Check Microsoft service status. If Teams is down for everyone, no local fix will help. Visit the Microsoft 365 Service Health page (requires admin login) or check third-party status sites to see if there’s an outage.
  • Use the Teams mobile app. If your desktop is having issues, the mobile app often works fine and keeps you reachable.

Troubleshooting

If the steps above don’t resolve the issue, try these additional checks:

  • Test with another network. Connect your computer to a mobile hotspot and launch Teams. If it connects, the problem is your home/office network configuration, not Teams itself.
  • Check DNS settings. Flush your DNS cache by opening Command Prompt as administrator and running ipconfig /flushdns. Then restart Teams.
  • Look for conflicting apps. Some screen recorders, overlay tools, or other communication apps can interfere with Teams’ network ports. Close them one by one to isolate the culprit.
  • Check the Teams log files. Navigate to %appdata%\Microsoft\Teams\logs.txt and look for lines containing “ERROR” or “Disconnected.” These can hint at the specific failure point (e.g., authentication vs. network timeout).
  • Reset Windows network stack. In Command Prompt (admin), run netsh winsock reset and netsh int ip reset, then restart your computer. This clears corrupted network settings.
  • Try a different user account. If another Windows user profile connects to Teams fine, your profile’s settings or cached credentials may be corrupted. Create a new local user and test.

Frequently Asked Questions

Why does Teams keep saying “disconnected” even when my internet works?

Teams uses specific ports (443 for HTTPS) and requires a stable connection to Microsoft servers. A VPN, proxy, firewall rule, or even a weak Wi-Fi signal can block it while other websites still load. Also, an outdated Teams client or corrupted cache can cause this.

Will clearing the Teams cache delete my messages or files?

No. The cache only stores temporary data like images, thumbnails, and settings. Your chats, files, and team content are stored on Microsoft’s servers, so they remain intact after clearing the cache.

How often should I update Teams?

Teams updates automatically in the background by default. You can manually check by clicking your profile picture and selecting Check for updates. Keeping it current reduces the chance of connectivity bugs.

Can I use Teams in a browser if the desktop app is broken?

Yes. Go to teams.microsoft.com and sign in. The web version supports most features including chat, meetings, and file sharing. It’s a good temporary fix while you troubleshoot the desktop app.

Does the disconnected error affect calls and meetings?

Yes. When Teams is disconnected, you can’t make or receive calls, join meetings, or send messages. Your status may show as “Offline” to others even if you’re actively using the app.

Is there a way to prevent disconnects in the future?

Keep Teams updated, use a stable wired connection when possible, avoid VPNs unless necessary, and periodically clear the cache (every few months) to prevent buildup of corrupt temporary files.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →