Use external monitors with your MacBook open and its built-in screen disconnected

Keep your MacBook open so you can use its keyboard and trackpad, while your external monitors provide the active desktops. On a supported Mac, BetterDisplay can disconnect the built-in screen without unplugging anything; try it manually first, then choose whether it should happen automatically at your desk.

Before you begin

Soft disconnection removes the built-in display from the desktop layout. Turning its brightness down or blanking it can leave an active desktop where windows and the pointer can still go. Closing the lid is a different macOS operating mode and makes the built-in keyboard and trackpad inaccessible. This tutorial does not require a sleep-disabling command.

Try manual disconnection first

  1. Open Settings > Displays > Overview > Display Connections and ensure Enable connect/disconnect option for displays is on. It normally starts on.
  2. Open Connection Management Settings…. Keep Allow disconnecting all connected displays off and Auto-connect all displays when no connected displays left on. Leave Disconnect built-in display when an external display is connected off for this first test. Record previous values before changing them. These preferences save without an Apply button.
  3. Close the sheet. In Settings > Displays, select the built-in display, normally named Built-in Display, in the sidebar. At the top of its page, turn Connect this display off. If that switch is absent or unavailable, follow the troubleshooting checks below rather than removing a safety restriction.
  4. If the Disconnecting a Display confirmation appears, read it and choose Disconnect. Wait for the display layout to settle; an external monitor may briefly go black while its output mode changes. On compatible Apple silicon hardware, the built-in panel should enter standby while the external desktop remains usable.
  5. Check that the built-in page now reports Display status: Soft-disconnected and its Connect this display switch is off. Use the MacBook keyboard and trackpad to work on the external desktop.

Built-in Display Settings with a genuine Soft-disconnected status and the Connect this display return switch off.

The built-in desktop is disconnected; its switch provides the manual return path.

Now test the return path: turn Connect this display back on and confirm that the built-in screen shows a desktop again. You can also use its header power switch in the app menu when that switch is configured for Connect/Disconnect or its normal Default behavior. Do not hold Shift while using the menu switch: that modifier can invert the connection state of other displays.

Repeat the manual disconnect only after reconnection works. A dark panel alone is not the result check: the screen should be removed from the active desktop layout, and the external desktop must remain accessible.

Disconnect automatically at your desk

Use the automatic rule if you normally want the built-in screen out of the way whenever a suitable external monitor is connected. The rule is off by default and applies to physical connection as well as reconnection through BetterDisplay.

  1. With the built-in display reconnected and an external desktop working, return to Settings > Displays > Overview > Display Connections > Connection Management Settings….
  2. Keep Allow disconnecting all connected displays off. Keep Auto-connect all displays when no connected displays left on, and retain the normal on settings for Auto-connect all displays on startup and Auto-connect all displays on quit unless you have a separate, planned workflow. Do not enable Disconnect reconnected displays upon wake or Aggressive disconnect merely for this tutorial.
  3. Under Built-in Display, enable Disconnect built-in display when an external display is connected. Close the sheet. The rule is saved without Apply or restart; it is evaluated when the display configuration changes.
  4. If the built-in desktop is still visible, disconnect and reconnect the native external monitor’s cable, then wait for configuration to settle. Confirm that the built-in screen disconnects when the external desktop returns. If an earlier configuration change has already disconnected it, you do not need to repeat the cable test. If you want to bring it back temporarily, use Connect this display or the app-menu header switch as described above.

Connection Management Settings with automatic built-in disconnection enabled and normal startup, quit and no-display reconnection safeguards on.

Enable the desk rule while retaining the normal disconnection and reconnection safeguards.

The trigger must be a connected external display that is neither a BetterDisplay virtual screen nor a system-virtual display, and that has no per-monitor exception. AirPlay and Sidecar therefore do not trigger it. A system-virtual DisplayLink screen does not trigger it either, even though a registered DisplayLink screen can count as the other eligible screen for a manual disconnect. On a mixed desk, a suitable native monitor can trigger the rule while DisplayLink monitors remain in use.

Choose which monitors trigger the rule

For example, you may want your desk monitor to disconnect the built-in screen, while a meeting-room projector leaves it available.

  1. Select the external display that should not trigger the rule in Settings > Displays > [display] > General Settings.
  2. Open Additional Settings…. Under Display Connections, enable Ignore for built-in display auto-disconnect. This exception is saved for that display.
  3. Leave that exception off for your desk monitor. If any qualifying connected monitor still has its exception off, the built-in display can still be disconnected. This is not a rule that requires every external monitor to participate.
  4. If you changed the exception to bring the built-in display back, reconnect it manually. Saving an exception prevents that monitor from triggering the rule; it does not itself reconnect an already disconnected screen.

Studio Display XDR Display Connections settings with Default behavior, Aggressive disconnect off and Ignore for built-in display auto-disconnect on; the built-in is connected and FlipAction Pro is soft-disconnected.

Exclude the sole qualifying external display from the built-in auto-disconnect rule; this does not itself reconnect the built-in screen.

Optional: use BetterDisplay's own keyboard toggle

Open Settings > Keyboard > Keyboard Shortcuts… > Display Connection and record an unused combination beside Toggle built-in display. For example, use Control–Option–Command–B if it is not already assigned. Close the recorder, press the combination to disconnect, then press it again to reconnect. Restore or clear your temporary binding when finished; see Custom Keyboard Shortcuts.

Manual reconnection through Settings, the app menu or this built-in keyboard action temporarily suspends the automatic rule. The suspension ends when the built-in screen is disconnected again, BetterDisplay restarts, or you change the automatic preference. The preference itself remains on during the suspension.

The macOS Shortcuts action Connect or Disconnect a Display and CLI connection commands do not apply that temporary suspension. With the automatic rule on and a qualifying external monitor connected, they can reconnect the built-in screen only for it to be disconnected again. If automation should decide when it stays on, turn the automatic rule off first. See why the built-in display turns off again after a Shortcut reconnects it.

Check the result

Automatic recovery is an attempt, not a guarantee. A generic wake-time display placeholder or a virtual-only desktop is not treated as ordinary evidence that a usable screen remains; a registered DisplayLink screen can count as eligible. An exclusive system virtual-display session can block physical reconnection until that session ends, and a closed lid prevents normal built-in reconnection.

Troubleshooting

If you use an Intel MacBook

Manual soft disconnection is available, but it does not fully put an Intel display to sleep. Fully dim display on disconnect in Connection Management Settings… defaults to on and lowers the selected brightness control to zero; BetterDisplay retains the previous value for reconnection. The automatic built-in-disconnection rule is Apple silicon-only.

Undo the setup and restore the built-in display

  1. While an external desktop is usable, turn Disconnect built-in display when an external display is connected off in Connection Management Settings….
  2. Select the built-in display under Settings > Displays and turn Connect this display on, or use its connection-configured app-menu header switch. Confirm that the panel and desktop return before unplugging your recovery monitor.
  3. Restore any per-monitor exceptions and temporary keyboard binding you changed. Restore recorded connection preferences, brightness, main-display choice and arrangement as needed. If the automatic rule was originally on, restoring it can disconnect the built-in screen again at the next configuration change; first re-establish the original working external setup. Window positions may need manual correction after a desktop was removed.
  4. If you also want to disable connection management, first reconnect every display you need, then turn Enable connect/disconnect option for displays off. Do not rely on a prompt appearing at that point to reconnect stranded displays.

If app reconnection fails on Apple silicon, try closing and reopening the MacBook lid with the external monitor still available, then reassess the display state. Keep the automatic rule off for recovery. Ordinary BetterDisplay quit normally attempts reconnection when Auto-connect all displays on quit is enabled; forced termination cannot provide that cleanup. If access cannot be restored, a Mac restart may be necessary.

Additional information

This section describes the license and hardware requirements for this workflow.

Features requiring Pro license

Display connection management, automatic built-in disconnection, per-monitor exceptions and the built-in-display keyboard action require Pro features, available with an active license or trial. Settings and the app-menu connection switch allow an app-disconnected display to be reconnected when Pro is unavailable. An already enabled automatic built-in preference remains available to turn off.

Platform compatibility

This tutorial documents BetterDisplay on macOS 26.3 or later. The automatic rule requires Apple silicon and a qualifying non-virtual external display. Manual soft disconnection is also available on Intel with the dimming and physical-recovery limitations above. Built-in model safeguards remain in force; native external-display counts, modes and standby behavior depend on the Mac and connection.