// troubleshooting guide · aerospace
AeroSpace Wrong Window Focus With Multiple Monitors
- Status
- Ongoing
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · aerospace/wrong-window-focus-multiple-monitors4 FIXES
// quick answer
Focus jumping to the wrong window or back again on multi-monitor setups is mostly caused by the macOS 'Displays have separate Spaces' setting. The official guide recommends turning it off and logging out.
Most likely fix: Disable 'Displays have separate Spaces'
How to fix it
// try these in order, the most common fix is first
FIX 1Disable 'Displays have separate Spaces'
- 01System Settings > Desktop & Dock > turn off 'Displays have separate Spaces'
- 02Or run: defaults write com.apple.spaces spans-displays -bool true && killall SystemUIServer
- 03Log out and back in
- 04Trade-off: the menu bar shows only on the main display
Did this fix it?FIX 2Pin workspaces to monitors
- 01Add a [workspace-to-monitor-force-assignment] section to ~/.aerospace.toml
- 02Map each workspace to a monitor (for example main or secondary)
- 03Run aerospace reload-config
Did this fix it?FIX 3Move a workspace back by hand
- 01Use move-workspace-to-monitor or move-node-to-monitor bound to a key
- 02Or use move-node-to-workspace for a single window
Did this fix it?FIX 4Update AeroSpace
- 01Run brew upgrade --cask nikitabobko/tap/aerospace
- 02Track #1216 for the core refactor that targets random jumping
Did this fix it?
SANDBOX · aerospace RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on AeroSpace-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
The wrong window receives focus, focus snaps back to the previous app, windows move back to the laptop screen, or windows jump to another workspace.
Why it happens
- C-01'Displays have separate Spaces' is enabled (macOS default)
- C-02Known pre-1.0 bug where windows can jump to the focused workspace (#1216)
- C-03Old AeroSpace versions (wrong-focus fix landed in 0.11.1)
- C-04Workspaces not pinned to a specific monitor
// this guide also covers
- aerospace multiple monitors
- aerospace focus wrong window
- aerospace windows jump workspace
- aerospace second monitor
Still not working?
If AeroSpace keeps failing, you're not alone. See every AeroSpace problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usOther AeroSpace errors
- AeroSpace Slow When Switching Workspaces
- AeroSpace Windows Stuck in Corner of Screen
- AeroSpace Not Working After Update (Accessibility Permission)
- AeroSpace Keybindings Not Working
- AeroSpace Tiles Popup Windows Instead of Floating
- AeroSpace Treats Tabs as Separate Windows
- AeroSpace Mission Control Windows Too Small
- How to Reset a Messed Up AeroSpace Layout