Screen sharing not working in Teams
Clicking 'Share' does nothing or the stream stays black. This guide covers the common causes.
Last verified:
Affected systems
windows macos linux
Quick fixes
- Restart Teams completely
- macOS: grant Screen Recording permission in System Settings
- Disable hardware acceleration in Teams settings
Allow Screen Recording on macOS
On the first attempt macOS asks for permission. If you declined back then, enable it manually:
- System Settings, Privacy and Security, Screen Recording.
- Enable Microsoft Teams.
- Quit and relaunch Teams - permissions are only evaluated on launch.
Disable hardware acceleration
GPU driver conflicts often produce a black share rectangle. Workaround:
- In Teams click your profile, Settings.
- General, disable hardware acceleration.
- Restart Teams.
Wrong monitor selected
With multiple monitors Teams often picks the wrong one. Before clicking ‘Share’ confirm the right monitor is highlighted.
Linux: check PipeWire
On Wayland-based Linux distros Teams needs PipeWire with xdg-desktop-portal.
If the picker does not appear, verify xdg-desktop-portal and
pipewire-pulse are installed.
Bandwidth too low
If the share updates very slowly, the network is too tight. Disabling other video streams (camera) in Teams frees a lot of capacity.