Teams Client Crash Action Plan

When Teams closes on its own, hangs, or falls into a restart loop, work through these checks in order before reinstalling, then collect the right logs if crashes continue.

MStack360 Team

5 min read

Gemini_Generated_crash thumpnail

IN 30 SECONDSFull read: 5 min

  • Check that antivirus and DLP tools allow Teams and WebView2 before anything else.
  • Quit fully from the tray, sign out and in, clear the cache, then update Teams and WebView2.
  • Reinstalling is step five, not step one.

When Teams closes on its own, keeps hanging, or falls into a restart loop, work through the checks in order rather than jumping straight to a reinstall. This plan starts with the fixes that resolve the most cases, then moves toward log collection and escalation only if the crashes continue.

Confirm the scope first#

A few quick checks tell you whether you are chasing a client problem or something wider, which saves you from reinstalling on the wrong machine.

Scope checks

0 of 4 done

Work through the fixes in order#

Each step is quick to try. Test after each one before moving on, so you know which change actually fixed it.

1. Quit and restart Teams fully#

On Windows, right select the Teams icon in the taskbar or system tray, choose Quit, then reopen Teams. Microsoft recommends a full restart to force a refresh for client issues. A normal window close is not enough, since Teams keeps running in the tray.

2. Sign out and sign back in#

Select your profile picture, choose Sign out, reopen Teams, and sign back in. Microsoft lists this as a basic troubleshooting step, and it clears many session and token related faults.

3. Clear the Teams client cache#

Clearing the cache resolves a wide range of client issues, and Teams should be restarted afterward. Use the method that matches the client and platform:

New Teams on Windows: go to Settings, Apps, Installed apps, Microsoft Teams, Advanced options, then Reset. You can also delete the cache path documented by Microsoft.

Classic Teams on Windows: quit Teams, open the cache folder, delete its contents, then restart Teams.

Text
%appdata%\Microsoft\Teams

macOS: use the Microsoft documented cache removal commands for classic or new Teams, then restart Teams.

4. Update Teams and WebView2#

Make sure both the Teams desktop app and the Microsoft Edge WebView2 Runtime are fully up to date. A partially installed update or a stale WebView2 build causes restart loops, and a "language changes detected, restart Teams" banner that will not clear is a related symptom some users see alongside this.

5. Reinstall Teams if cache and reset do not help#

If clearing the cache or resetting the client does not stop the crashes, uninstall and reinstall Teams following Microsoft's guidance. This replaces any corrupted client files left behind.

6. Check audio and video drivers#

Keep audio and video drivers updated for Teams stability, especially when crash insights point to the media stack. If the media stack still fails after driver updates and your security tools are confirmed to allow Teams, enable Windows Error Reporting to help identify the root cause and report it to Microsoft.

Rule out interfering software and runtimes#

Some crashes never show up cleanly in crash dumps for either the desktop client or the WebView2 runtime. These are usually caused by security or endpoint software hooking into Teams, or by a missing system runtime.

  • Add the required exclusions. Exclude the Teams and WebView2 binaries from third party antivirus, DLP, and endpoint security tools. If adding these exclusions does not resolve the issue, move on to log collection and escalation.
  • Install missing runtimes. Confirm the machine has current Microsoft Edge WebView2, the .NET Framework, and DirectX installed. A missing or outdated runtime can trigger silent crashes that leave little in the logs.
  • Isolate the environment. Test on another PC, on a different network such as a phone hotspot, with a Windows clean boot, and with a fresh Windows user profile. Each test rules out one common external cause.

These endpoint and security products are known to interfere with Teams and produce crashes that are hard to trace. Check the running processes on an affected machine for any of them:

  • BeyondTrust or Avecto (PGHook.dll)
  • Aternity
  • Zscaler
  • CrowdStrike (Umppc*.dll)
  • ControlUp
  • McAfee, including McAfee Drive Encryption. If this is present, upgrading Drive Encryption to 7.4.0 is suggested.

Read the WebView2 exit code#

When a crash is caused by a WebView2 process failure, the exit or error code points you toward the category of problem. A few of the most useful codes are below. The full reference lives in Microsoft's crash issue article.

  • 1

    Name
    RESULT_CODE_KILLED
    What it usually means
    The process was forcibly terminated by the system or an external controller, which often points back to security software.
  • 2

    Name
    RESULT_CODE_HUNG
    What it usually means
    The process stopped responding and was terminated to prevent further issues.
  • 4

    Name
    RESULT_CODE_GPU_DEAD_ON_ARRIVAL
    What it usually means
    The GPU process failed at startup, usually from driver issues or hardware incompatibility.
  • -536870904

    Name
    Out of Memory
    What it usually means
    The process ran out of available memory during execution.
  • -1073740940

    Name
    STATUS_HEAP_CORRUPTION
    What it usually means
    The heap structure is corrupted, which can cause unpredictable behavior.
  • -1073741819

    Name
    STATUS_ACCESS_VIOLATION
    What it usually means
    A memory access violation occurred, causing the crash.
  • -1073739514

    Name
    STATUS_VIRUS_INFECTED
    What it usually means
    The process was terminated because antivirus flagged it, another sign to review your exclusions.

Collect logs before escalating#

If crashes continue after the documented fixes, gather diagnostics first so support has what it needs on the first pass.

Before you escalate

0 of 4 done

Common questions#

Common questions

Why does closing the Teams window not stop the crashes?

Teams keeps running in the system tray after you close its window. A full Quit from the tray icon is what forces the client to refresh, which is why step one matters before you try anything more involved.

The crash does not appear in any dump file. What now?

Crashes with no visible dump for the desktop client or WebView2 are usually caused by external software hooking into Teams. Review running processes for the endpoint and security tools listed above, and confirm the required exclusions are in place.

Should I reinstall Teams straight away?

No. Reinstalling is step five, not step one. Restarting, signing out and in, clearing the cache, and updating both Teams and WebView2 resolve most crashes without a reinstall, and they take far less time.

SHARE THIS ARTICLE

Rather have us do it for you?

A free 15-minute call. We look at your tenant and tell you what to fix first.

Book a Free Call

WRITTEN BY

MStack360 Team

The MStack360 team delivers Microsoft 365 migrations, security and Power Platform projects for businesses across North America, Europe, Australia and the Middle East.

Ready to Transform Your
Microsoft 365 Environment?

Get a free consultation and discover which level is right for your business.

No commitment
Free 15-min call
500+ clients served

Prefer to browse first? See our service levels →