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

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

  1. FIX 1Toggle floating for one window

    1. 01Focus the window
    2. 02Press alt-shift-; to enter service mode
    3. 03Press f to toggle floating/tiling (default config)
    Did this fix it?
  2. FIX 2Float an app automatically

    1. 01Find its bundle ID with aerospace list-apps
    2. 02Add to ~/.aerospace.toml: [[on-window-detected]] if = 'test %{app-bundle-id} = <bundle id>' run = 'layout floating'
    3. 03Run aerospace reload-config
    Did this fix it?
  3. FIX 3Force tiling for misdetected apps

    1. 01Use the same on-window-detected rule with run = 'layout tiling'
    2. 02Note: since v0.21.0 rules with an empty if clause are rejected
    Did this fix it?
  4. FIX 4Report it

    1. 01Run aerospace debug-windows and reproduce
    2. 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 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