Microsoft Teams Whiteboard Black Screen: Troubleshooting

When Whiteboard opens in Microsoft Teams but the canvas stays black, the cause is usually local rendering, a stale app state, a network restriction or the board itself, not broken hardware. This guide helps you narrow it down and try reversible fixes before contacting support.

Identify the symptom and environment

First confirm what is black. A whiteboard shared natively in a meeting is different from a Whiteboard window shown through screen sharing, and both are different from a participant's video tile. If the black area is your own video preview, this is a camera problem: check the selected camera and the camera permission instead, because whiteboard fixes will not help.

Then note your environment and when the problem occurs:

• Which Teams client you use: the desktop app (classic or new Teams) or Teams in a web browser.
• Your operating system and, for the web client, your browser.
• Whether the board is black from the start, turns black after a while, or turns black after resizing, moving the window or changing displays.
• Whether it happens in every meeting or only with one particular board.
• Any error message or loading indicator shown on or around the canvas.

Isolate where the fault occurs

Use a few quick comparisons to separate a local problem from one affecting the board, your account or your organisation.

• Ask another participant whether they see the board normally. If only you see a black canvas, the cause is most likely on your device or client. If everyone does, focus on the board, the service or organisation settings.
• Open the same meeting in Teams on the web. If the board works there, the desktop app, its cache or graphics rendering is the likely cause.
• Open the board outside Teams in Microsoft Whiteboard, if your account has access to it. If it works there, the issue is on the Teams side.
• Try another network, such as a different Wi-Fi or a mobile hotspot, if your organisation allows it. If the board loads there, a firewall, proxy or VPN may be blocking content.
• If you were sharing the Whiteboard window through screen sharing, try sharing the board directly from the meeting's share options instead. Some windows appear black to viewers when captured through screen sharing.

Try reversible fixes in order

Work through these steps one at a time and reopen the board after each one, so you know which change made the difference. Menu labels differ between classic Teams, new Teams and the web client, so look for the equivalent option in your version.

• Close the whiteboard and reopen it from the meeting. Expected result: the canvas redraws with its content.
• If you use more than one monitor, move the Teams window to your main display, or keep it there, and avoid changing display resolution or scaling during the meeting. Expected result: the canvas renders after the window settles.
• Fully quit Teams rather than just closing its window, then start it again and rejoin. On Windows, quit from the Teams icon in the notification area; on macOS, use Quit from the app menu.
• Update Teams. New Teams normally updates itself; classic Teams offered a manual check for updates in its profile or settings menu. Restart after updating.
• Update your graphics driver through your operating system's update tool or the hardware manufacturer's official utility. Avoid driver packages from unknown sources.
• In classic Teams, a setting to disable GPU hardware acceleration was available in general settings. Turning it on and restarting Teams can fix black rendering on some systems. New Teams may not show this option; do not assume it exists in your version.
• Clear the Teams cache using the method Microsoft documents for your Teams version and operating system. Quit Teams first. You may need to sign in again afterwards, but your chats and files are stored in the service, not in the cache.
• In the web client, open the meeting in a private browser window to rule out extensions, and confirm the browser is up to date and supported by Teams.
• Check the board itself. Some Whiteboard versions let you change the board background, and a dark background with dark ink can look like an empty black screen. Zoom out or select all content to see whether strokes are present.

Confirm the result

After a fix, reopen the same board that was black, draw a short stroke and confirm it appears. Ask another participant to confirm they see your stroke and that you see theirs. Then quit and restart Teams, rejoin, and check again: a fix that only lasts until the next restart points to a cache or rendering issue that may return.

Undo changes you no longer need, such as a temporary network switch. Do not disable antivirus, firewall or other security protections to test the board; if a network block is suspected, raise it with whoever manages your network.

If the problem remains

Keep a short record of what you observed, as it saves time for whoever helps you next:

• Teams client and version, operating system and, for the web client, the browser.
• Whether other participants, the web client and Whiteboard outside Teams showed the board correctly.
• Which network you tested and whether a VPN or proxy was in use.
• The fixes you tried, in order, and what changed after each one.
• Screenshots of the black canvas and any error message, with the date and time it happened.

If the board fails for everyone or only on your organisation's network, contact your IT administrator: Whiteboard availability, storage and network access can be controlled by organisation settings that users cannot change. If it fails only on one device and only in the desktop app, your administrator or Microsoft support can review the client and logs. A black whiteboard on its own does not prove a graphics card fault; consider device repair only if other apps also show display corruption or black windows.