Microsoft Teams screen sharing on Mac: setup that works

Teams on macOS has one setup step that trips up nearly everyone the first time, and one sharing habit that removes most of the risk afterwards. Both take a minute.

Fix the permission first

The classic Teams-on-Mac symptom is a share that starts successfully and shows everyone a black rectangle. That is macOS withholding screen recording permission, not a Teams bug.

1. Open System Settings → Privacy & Security → Screen & System Audio Recording.
2. Turn on Microsoft Teams.
3. Quit Teams completely — Cmd-Q, and check it is not still in the Dock — then reopen it.

The relaunch is the part people skip. macOS applies the new permission when the app next starts, so a running copy keeps failing no matter how many times you toggle the switch.

Share a window rather than the desktop

Teams lists your displays and your open windows when you click the share button. Choosing a specific window means only that window is transmitted, so switching to another app in front of it shows viewers nothing. It is the single biggest reduction in screen-share risk available in any meeting app.

Two caveats specific to Teams on macOS. Window sharing does not follow an app that opens a new window — if your app spawns a separate dialog or a second document window, viewers will not see it, and you will keep talking to a still image. And if you need to demonstrate a workflow that moves between apps, window sharing will fight you; share the display and clear it properly instead.

What Teams cannot tidy for you

Share a whole display and everything macOS draws is in frame: desktop file names, the Dock with its recent apps section, desktop widgets, and the Stage Manager strip showing thumbnails of your other window groups. Teams has no control over any of it.

The widgets are worth singling out, because the calendar widget displays event titles on your wallpaper and those are frequently the most sensitive thing on screen.

# hide desktop widgets
defaults write com.apple.WindowManager StandardHideWidgets -bool true

# undo
defaults write com.apple.WindowManager StandardHideWidgets -bool false

See the desktop widgets guide for the System Settings route and what each widget exposes.

Notifications, including Teams' own

Teams is a notification-heavy app, and during a shared screen its own message banners are the ones most likely to embarrass you — a colleague's reply about the very meeting you are in, arriving in front of the client. Do Not Disturb before joining is the fix, and no app can set it for you.

If you present often, build the shortcut once so it is muscle memory rather than a menu hunt: setting a Do Not Disturb keyboard shortcut.

Common questions

Why is my Teams screen share black on Mac?

Microsoft Teams is missing screen recording permission. Enable it under Privacy & Security → Screen & System Audio Recording, then fully quit Teams and reopen it.

Do I need to restart my Mac after granting permission?

No, but you must fully quit and relaunch Teams. macOS only applies the new permission when the app next starts.

Can Teams hide my desktop icons?

No. Desktop icons, the Dock and widgets are macOS, so hide them yourself before sharing a full display.

Why can viewers not see a dialog box I opened?

Window sharing transmits only the window you selected. A new window or dialog is a separate window, so share the display if your workflow opens extra windows.

Does Teams stop my own notifications while sharing?

Not reliably, and its own message banners are the most likely to appear. Turn on Do Not Disturb before you join.

The two-minute setup

Grant the permission, relaunch Teams, set a Do Not Disturb shortcut, and default to sharing a window. After that the only per-meeting work is clearing the macOS clutter, which Meeting Mode does in a click.