// troubleshooting guide · aerospace

AeroSpace Wrong Window Focus With Multiple Monitors

Status
Ongoing
platforms:
macOS
updated:
November 16, 2026
reports:
3
Method
how we research
Share

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

  1. FIX 1Disable 'Displays have separate Spaces'

    1. 01System Settings > Desktop & Dock > turn off 'Displays have separate Spaces'
    2. 02Or run: defaults write com.apple.spaces spans-displays -bool true && killall SystemUIServer
    3. 03Log out and back in
    4. 04Trade-off: the menu bar shows only on the main display
    Did this fix it?
  2. FIX 2Pin workspaces to monitors

    1. 01Add a [workspace-to-monitor-force-assignment] section to ~/.aerospace.toml
    2. 02Map each workspace to a monitor (for example main or secondary)
    3. 03Run aerospace reload-config
    Did this fix it?
  3. FIX 3Move a workspace back by hand

    1. 01Use move-workspace-to-monitor or move-node-to-monitor bound to a key
    2. 02Or use move-node-to-workspace for a single window
    Did this fix it?
  4. FIX 4Update AeroSpace

    1. 01Run brew upgrade --cask nikitabobko/tap/aerospace
    2. 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 us

Watch AeroSpace Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other AeroSpace errors