// 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
Share

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

  1. FIX 1Flatten the workspace tree

    1. 01Press alt-shift-; to enter service mode
    2. 02Press r (flatten-workspace-tree) to reset the layout
    3. 03Or run aerospace flatten-workspace-tree
    Did this fix it?
  2. FIX 2Balance window sizes

    1. 01Run aerospace balance-sizes or bind it to a key
    Did this fix it?
  3. FIX 3Close everything but the current window

    1. 01In service mode press backspace (close-all-windows-but-current)
    Did this fix it?
  4. FIX 4Keep normalizations on

    1. 01Make sure enable-normalization-flatten-containers and enable-normalization-opposite-orientation-for-nested-containers are true
    2. 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 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