Hello folks! You close your MacBook lid, plug it into your external monitor, and — nothing. Or worse, the screen wakes up but everything looks stretched, blurry, or stuck at some resolution your monitor was never meant to run. If you updated to macOS Tahoe recently, you’re not imagining it. This clamshell mode bug has been showing up in Apple’s own support forums for months, and it’s annoying enough that I spent a whole Saturday afternoon chasing it down on my own Mac mini setup.
Here’s the full walkthrough, in the order I’d actually try these fixes.
1. Force macOS to redetect your display
This sounds too simple, but it fixes the problem for a lot of people, so start here.
Steps
- Wake your Mac (press a key or click the mouse connected to the external display).
- Open the Apple menu and go to System Settings > Displays.
- Hold down the Option key. You’ll see the “Detect Displays” button appear (or change).
- Click Detect Displays while still holding Option.
Your screen might flicker or go black for a second. That’s normal. Give it about 5 seconds to settle.
2. Stop your Mac from picking a resolution your monitor can’t handle
The core problem seems to be that when the Mac exits sleep in clamshell mode, it sometimes remembers the wrong refresh rate or resolution for your specific monitor and cable combo. A few things help:
Lower the refresh rate
In System Settings > Displays, click your external display and try dropping the refresh rate one notch, say from 60Hz to 50Hz, then back up. Weirdly, this “unsticks” the wrong setting for a lot of monitors. I know it sounds like a placebo, but it worked twice for me on two different displays.
Try a different cable or port
If you’re using a USB-C to HDMI dongle, swap it for a direct Thunderbolt or USB-C cable if your monitor supports it. Cheap dongles are a common cause of resolution confusion after sleep, and this bug seems to make that worse.

3. Turn on “Prevent automatic sleeping” for your display
This one’s easy to miss because it’s tucked away in a menu most people never open.
Steps
- Go to System Settings > Battery.
- Click the Options button (you may need to scroll down).
- Turn on Prevent automatic sleeping on power adapter when the display is off.
This keeps your Mac’s display connection alive instead of fully powering it down, which seems to be where the wrong-resolution bug creeps in. It’s a small toggle but it made my setup noticeably more reliable.

4. Reset the display preferences (the nuclear option)
If nothing above sticks, the fix that consistently works is resetting the files macOS uses to remember your display setup. This sounds scarier than it is. You’re not deleting anything permanent, just the “memory” of your monitor configuration, which macOS will rebuild automatically.
Steps
- Quit any open apps that might have unsaved work, just to be safe.
- Open Terminal (search for it with Spotlight, Command-Space).
- Type this and press Return:
rm ~/Library/Preferences/ByHost/com.apple.windowserver.*.plist - Log out (Apple menu > Log Out) or restart your Mac.
After logging back in, reconnect your external monitor. macOS will treat it like a brand-new display and build a fresh profile for it. This is the step that finally solved it for good on my setup, after the other fixes kept only working for a day or two.
Tips and troubleshooting
- Update to the latest macOS Tahoe point release. Apple has quietly patched parts of this bug in recent updates, so an outdated system makes it worse.
- If you’re on a MacBook (not a Mac mini or Mac Studio), check that “Prevent your Mac from sleeping automatically when the display is off” isn’t fighting with your lid-closed settings. Clamshell mode needs the Mac to stay awake, so a conflicting setting can undo your fix.
- Some third-party display utilities (like ones that manage multiple monitors or scaling) can interfere here too. Quit them temporarily and test again before assuming it’s a macOS bug.
- Still stuck? Try a full NVRAM reset. On Apple Silicon Macs this happens automatically on restart in most cases, so check Apple’s official guide for your specific Mac model before trying manual steps.
Frequently asked questions
Why does my external monitor go black when I close my MacBook lid?
Usually this means clamshell mode isn’t detecting your monitor fast enough, or your Mac went into a deeper sleep than expected. Make sure your Mac is plugged into power, has a mouse or keyboard connected (wired or already-paired Bluetooth), and try the “Detect Displays” trick from Step 1 above.
Does this only happen with certain monitors?
No, but cheaper monitors and USB-C to HDMI dongles seem to trigger it more often. If you have the option, use a direct DisplayPort or Thunderbolt cable instead of an adapter.
Will Apple fix this in a future update?
Likely, at least partly. Apple has already shipped small fixes to sleep and wake behavior in recent Tahoe point releases. Keeping your Mac updated is still one of the easiest things you can do while you wait.
Is it safe to delete the WindowServer plist files?
Yes. These files only store your display arrangement and resolution preferences, not any personal data or app settings. Worst case, you’ll need to rearrange your monitors again after restarting.
Wrapping up
This bug is one of those small things that shouldn’t be this annoying, but when your whole workday depends on a second monitor, it adds up fast. Start with the Option-click display detection, work your way down, and the plist reset should be your last resort if the others don’t hold. Has one of these fixes worked for you, or did you find a different workaround? Let me know in the comments.
Apple’s official guide on unexpected sleep and wake issues has more background if you want to dig deeper, especially if you’re also seeing this on a desktop Mac without clamshell mode involved.