MainspringGuides › Display not detected
macOS Guide

Mac Not Detecting an External Display? Fix List

Updated August 2026 · 3 min read

A monitor that stays black when you plug it in is usually a cable, a hub, or a limit of the Mac model rather than a fault. Work down this list in order and you will find it, and the third item catches more cases than most people expect.

The physical layer, in order

  1. Try a different cable. The single most common cause. USB-C cables in particular vary enormously: a charging cable that carries power will not carry video. You need one rated for video or Thunderbolt.
  2. Connect directly. Take the hub or dock out of the chain and plug the display straight into the Mac. If it works, the hub is the problem, and hubs fail at video far more often than at data.
  3. Try every port. On some Macs the ports differ in what they support.
  4. Check the display's input. Monitors do not always auto-switch. Set the input manually to the port you used.
  5. Power cycle the monitor. Unplug it from the wall for thirty seconds, not just off and on. Monitors hold state, and this genuinely fixes cases.

The hidden Detect Displays button

macOS used to show this and now hides it. Open System Settings → Displays, hold the Option key, and a Detect Displays button appears in the lower right. Click it with the monitor connected and powered on.

While you are there, check the Arrangement layout. A display positioned oddly, or set as a mirror when you expected an extension, can look like a display that is not working. And confirm which screen holds the menu bar — dialogs opening on a screen that is switched off looks identical to a display not being detected.

Check what your Mac actually supports

This is the answer people do not expect. Base-model Apple silicon Macs support a limited number of external displays — on several M-series MacBook Air and base MacBook Pro models, that is one external display, and a second simply will not appear no matter what you plug in. Pro and Max chips support more.

# what macOS reports about graphics and connected displays
system_profiler SPDisplaysDataType

Check your specific model on Apple's tech specs page. If you have hit the limit, a DisplayLink adapter with its driver is the workaround, since it delivers video over USB rather than through the display engine.

Resolution and refresh rate mismatches

A display can be detected and still show nothing if the mode is out of range. In Displays, hold Option and click Scaled to reveal every mode the Mac can drive, including ones macOS hides as unsuitable. Drop the refresh rate to 60 Hz and try again — high refresh rates over a marginal cable are a common cause of a black screen that flickers on briefly.

Docks, hubs and the power question

If the display works when connected directly and not through a dock, the dock is at fault, and the usual reason is power rather than data. A hub driving a display, charging the Mac and running drives needs its own power supply; a bus-powered hub will drop the display first when it runs short.

Two more dock-specific causes worth ruling out: firmware, since dock manufacturers ship updates that specifically address display detection on macOS, and DisplayPort mode, since some USB-C hubs support either high-resolution video or fast data but not both at once, and switch automatically. If a display works until you plug in an SSD, that is what happened.

Reset the display configuration

If a monitor that used to work has stopped, the saved configuration may be corrupt:

  1. In Finder press Command-Shift-G and go to /Library/Preferences.
  2. Move any files beginning com.apple.windowserver to your desktop.
  3. Restart the Mac and reconnect the display.

Also worth trying: boot with the display connected and powered on, since some monitors are only detected at startup, and check for a firmware update for the monitor itself. On a MacBook, closing the lid with an external display connected switches to clamshell mode, which requires power and an external keyboard or mouse — a display that "stops working" when the lid closes is usually this rather than a fault.

Once the display is working

Mainspring covers the settings around multi-display setups — Dock behaviour, menu bar options, Spaces per display — as labelled, reversible toggles.

Try Mainspring free →

Signed & notarized by Apple · 1-day free trial · $29 once