// troubleshooting guide · aerospace
AeroSpace Tiles Popup Windows Instead of Floating
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · aerospace/popups-tiled-not-floating4 FIXES
// quick answer
AeroSpace guesses which windows are dialogs, and some apps get it wrong. Toggle the window with the service-mode shortcut or add an on-window-detected rule that floats that app.
Most likely fix: Toggle floating for one window
How to fix it
// try these in order, the most common fix is first
FIX 1Toggle floating for one window
- 01Focus the window
- 02Press alt-shift-; to enter service mode
- 03Press f to toggle floating/tiling (default config)
Did this fix it?FIX 2Float an app automatically
- 01Find its bundle ID with aerospace list-apps
- 02Add to ~/.aerospace.toml: [[on-window-detected]] if = 'test %{app-bundle-id} = <bundle id>' run = 'layout floating'
- 03Run aerospace reload-config
Did this fix it?FIX 3Force tiling for misdetected apps
- 01Use the same on-window-detected rule with run = 'layout tiling'
- 02Note: since v0.21.0 rules with an empty if clause are rejected
Did this fix it?FIX 4Report it
- 01Run aerospace debug-windows and reproduce
- 02Attach the output to a GitHub Discussion
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
Small windows like System Settings, progress dialogs or app popups get stretched into a tile, or a normal window floats when it shouldn't.
Why it happens
- C-01Dialog detection relies on heuristics such as the missing fullscreen button
- C-02Some apps and Apple dialogs (Finder copy progress) are misdetected
- C-03Window titles set after the window appears, so title rules don't match
// this guide also covers
- aerospace float window
- aerospace floating rules
- aerospace dialog tiled
- aerospace on-window-detected
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 Wrong Window Focus With Multiple Monitors
- AeroSpace Treats Tabs as Separate Windows
- AeroSpace Mission Control Windows Too Small
- How to Reset a Messed Up AeroSpace Layout