Office Apps Not Opening

Fix Microsoft Teams Black Screen and Team Update Errors on Mac

Chanuka GeekiyanageChanuka Geekiyanage Nov 14, 2026 868 views

Question details

Resolve a black screen in Microsoft Teams on Mac or errors when updating team settings.

Fix Microsoft Teams Black Screen and Team Update Errors on Mac
Product
Microsoft Teams
Device & OS
macOS
Scenario
Teams shows a black screen or fails to update team settings after an application update, while it may still work in a browser or on another computer.
Observed behavior
The Mac desktop client displays a black screen or reports errors when team settings are updated.
Before you start

Check whether Teams works in your browser or on another device, and note whether the issue affects the desktop app or a specific team. If possible, ask a Microsoft 365 administrator to check for active Teams incidents.

Solution 1Recommended

Check Teams service health and use the web app

Use this first to determine whether a service incident is affecting Teams and to keep working while it is resolved.

1
Check service health

If you are an administrator, open the Microsoft 365 admin center at admin.microsoft.com and select Health > Service health. Look for active Microsoft Teams incidents or advisories.

2
Ask your administrator

If you cannot access the admin center, ask your Microsoft 365 administrator whether a Teams incident affects your organization.

3
Switch to another client

Open teams.microsoft.com in a supported browser and sign in, or use the Teams mobile app while the Mac desktop issue is investigated.

Check Teams service health and use the web app
Browser access does not rule out an incident: A service issue can affect the Mac desktop client even when Teams works in a browser or on another computer.
Free Microsoft Office alternative

Work on Office Documents with WPS Office

WPS Office is a free, lightweight alternative for working with Office documents in a familiar interface. Its format compatibility makes it easy to move existing files into your workflow. It does not fix or replace Microsoft Teams.

Open and edit Microsoft Word, Excel, and PowerPoint formats, including DOCX, XLSX, and PPTXWork on documents shared through Teams after downloading themUse a familiar interface for a smoother transition from Microsoft OfficeAccess a free, lightweight office suite
microsoft office alternative - wps office

Frequently Asked Questions

Why does Teams work in my browser but show a black screen on my Mac?

The problem may affect the Mac desktop client or its local data, and some service incidents affect one client but not another. Ask an administrator to check Health > Service health in the Microsoft 365 admin center.

Where can I check for a Microsoft Teams outage?

Microsoft 365 administrators can sign in to admin.microsoft.com and open Health > Service health to review Teams incidents and advisories. If you are not an administrator, ask your organization’s administrator to check.

Can I use Teams while the Mac app is not working?

Yes. Sign in at teams.microsoft.com using a supported browser, or use the Teams mobile app if it is available to you.

Does the classic Teams cache path apply to new Teams?

No. The path ~/Library/Application Support/Microsoft/Teams is for classic Teams. New Teams uses different local storage; follow Microsoft's current instructions for clearing its cache.