Fix Microsoft Teams Black Screen and Team Update Errors on Mac
Question details
Resolve a black screen in Microsoft Teams on Mac or errors when updating team settings.

- 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.
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.
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.
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.
If you cannot access the admin center, ask your Microsoft 365 administrator whether a Teams incident affects your organization.
Open teams.microsoft.com in a supported browser and sign in, or use the Teams mobile app while the Mac desktop issue is investigated.

Clear the classic Teams cache on Mac
Try this if team-setting errors persist and you are using the classic Teams desktop app.
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.

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.




