✅ Common Causes and Fixes
| What might be wrong | How to fix it |
|---|---|
| Selected wrong screen or window to share | When the screen sharing dialog appears, carefully select “Entire Screen” or your primary monitor (usually called “Screen 1” or “Display 1”), not “Application Window” or “Chrome Tab.” If you selected a specific application that’s minimized or closed, you’ll see black. Click “Stop Sharing” and restart, selecting the correct entire screen option. |
| macOS screen recording permission not granted | Mac: System Settings > Privacy & Security > Screen Recording > check the box next to your browser (Chrome, Safari, Firefox, Edge). Your browser must completely quit and restart after granting this permission. Without screen recording permission, macOS shows a black screen instead of your actual display for security reasons. |
| Hardware acceleration causing conflictsDisable hardware acceleration in your browser. | Chrome/Edge: Settings > System > turn OFF "Use hardware acceleration when available" > restart browser. Firefox: Settings > General > Performance > uncheck "Use hardware acceleration" > restart.Hardware acceleration can cause black screens with certain graphics cards or drivers. |
| Sharing application window that’s minimized | If you selected a specific application window to share (not entire screen), that window must remain open and visible on your screen. Minimizing it shows black. Either maximize the application or switch to sharing your entire screen instead, which shows everything regardless of what’s open. |
| Multiple monitors with wrong monitor selected | If you have multiple monitors, verify you’re sharing the correct one. When prompted, select the monitor where your test content is displayed. If you selected your secondary monitor but your test is on the primary, viewers see black or a blank desktop. Disconnect extra monitors if unsure which is which. |
| Browser doesn’t have permission to capture specific window | Some operating systems require additional permissions to capture certain windows. Mac: System Settings > Privacy & Security > Screen Recording must include your browser. Windows: Ensure no applications are blocking screen capture (some corporate security software prevents it). Try sharing entire screen instead of specific windows. |

