teams

Teams Chat Messages Not Syncing

Resolution Checklist

  • 1 Check Your Network Connection
  • 2 Force-Refresh and Restart Teams
  • 3 Clear the Teams Cache
  • 4 Check Teams Service Health
  • 5 Reinstall Teams or Use the Web Client

Teams Chat Messages Not Syncing

When Microsoft Teams messages fail to sync, you may experience messages not appearing in chat, long loading spinners, or conversations that look different on your phone versus your desktop. These sync problems are typically caused by network interruptions, a corrupted local cache, or a server-side outage.

Step 1: Check Your Network Connection

Teams requires a stable internet connection with access to Microsoft 365 cloud services. Sync failures often trace back to connectivity issues.

  1. Open a browser and navigate to https://teams.microsoft.com to verify you can reach Microsoft services.
  2. If the web version also fails to load messages, the problem is network-related.
  3. Run a quick connectivity test:
# macOS / Linux
ping -c 5 teams.microsoft.com
:: Windows
ping teams.microsoft.com
  1. If you see packet loss or high latency (above 200ms), troubleshoot your network connection first.
  • VPN users: Disconnect your VPN temporarily and check if messages sync. Some VPN configurations block Teams traffic.
  • Corporate firewalls: Ensure your network allows traffic to *.teams.microsoft.com and *.skype.com on ports 80 and 443.
  • If you are on Wi-Fi, try switching to a wired Ethernet connection for more stability.

Step 2: Force-Refresh and Restart Teams

A simple refresh can force Teams to re-fetch messages from the server.

  1. Press Ctrl + Shift + R (Windows) or Cmd + Shift + R (macOS) to hard-refresh the Teams client.
  2. If that does not work, fully quit Teams:
    • Windows: Right-click the Teams icon in the system tray > Quit.
    • macOS: Right-click the Teams icon in the Dock > Quit, or press Cmd + Q.
  3. Wait 10 seconds, then relaunch Teams.
  4. Navigate to the affected chat or channel and check if messages now appear.
  • If messages appear on the mobile app but not on desktop, the issue is specific to your desktop client’s local state.
  • Try signing out of Teams completely (Settings > Sign out) and signing back in.

Step 3: Clear the Teams Cache

A corrupted cache is the most frequent cause of persistent sync failures. Clearing it forces Teams to rebuild its local data from the server.

On Windows:

  1. Fully quit Teams (check Task Manager to confirm no Teams processes remain).
  2. Open File Explorer and navigate to:
%appdata%\Microsoft\Teams
  1. Delete the contents of these folders: Cache, blob_storage, databases, GPUCache, Local Storage, and tmp.
  2. Relaunch Teams.

On macOS:

  1. Quit Teams completely.
  2. Open Terminal and run:
rm -rf ~/Library/Application\ Support/Microsoft/Teams/Cache
rm -rf ~/Library/Application\ Support/Microsoft/Teams/databases
rm -rf ~/Library/Application\ Support/Microsoft/Teams/Local\ Storage
  1. Relaunch Teams and sign back in.

Clearing the cache will not delete your messages or files — all data is stored server-side and will re-sync automatically.

Step 4: Check Teams Service Health

Microsoft occasionally experiences service disruptions that affect message delivery across all users.

  1. Visit the Microsoft 365 Service Health Dashboard in your browser.

  2. Look for any active incidents under Microsoft Teams.

  3. You can also check from the Microsoft 365 Admin Center if you have admin access:

    • Go to Health > Service health and filter for Teams.

  4. Check community reports on DownDetector for Teams to see if other users are experiencing the same issue.

  • If there is an active outage, no local troubleshooting will help — you must wait for Microsoft to resolve it.
  • Consider using the Teams mobile app or Teams web client as a temporary workaround during outages, as different clients sometimes recover at different rates.

Step 5: Reinstall Teams or Use the Web Client

If clearing the cache did not resolve the issue and there is no service outage, a full reinstall may be necessary.

  1. Uninstall Teams:

    • Windows: Settings > Apps > find Microsoft Teams > Uninstall.
    • macOS: Drag Microsoft Teams from the Applications folder to the Trash.

  2. Delete any remaining data:

# macOS
rm -rf ~/Library/Application\ Support/Microsoft/Teams
rm -rf ~/Library/Caches/com.microsoft.teams*
:: Windows
rmdir /s /q %appdata%\Microsoft\Teams
rmdir /s /q %localappdata%\Microsoft\Teams
  1. Download and install the latest version from https://www.microsoft.com/en-us/microsoft-teams/download-app.
  2. Sign in and allow messages to sync. Initial sync may take several minutes for large chat histories.