// troubleshooting guide · aerospace
How to Reset a Messed Up AeroSpace Layout
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · aerospace/reset-layout4 FIXES
// quick answer
When AeroSpace's tile tree gets tangled, flatten the workspace tree from service mode (alt-shift-; then r) and balance sizes. Closing extra windows or reloading the config also helps.
Most likely fix: Flatten the workspace tree
How to fix it
// try these in order, the most common fix is first
FIX 1Flatten the workspace tree
- 01Press alt-shift-; to enter service mode
- 02Press r (flatten-workspace-tree) to reset the layout
- 03Or run aerospace flatten-workspace-tree
Did this fix it?FIX 2Balance window sizes
- 01Run aerospace balance-sizes or bind it to a key
Did this fix it?FIX 3Close everything but the current window
- 01In service mode press backspace (close-all-windows-but-current)
Did this fix it?FIX 4Keep normalizations on
- 01Make sure enable-normalization-flatten-containers and enable-normalization-opposite-orientation-for-nested-containers are true
- 02Run aerospace reload-config
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
Windows are nested in odd splits, some tiles are tiny, or new windows land in unexpected places.
Why it happens
- C-01Repeated join-with and move commands create deep nested containers
- C-02Resizing leaves uneven tile sizes
- C-03Normalization settings turned off in the config
// this guide also covers
- aerospace reset layout
- aerospace flatten workspace tree
- aerospace layout messed up
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 Tiles Popup Windows Instead of Floating
- AeroSpace Treats Tabs as Separate Windows
- AeroSpace Mission Control Windows Too Small