// troubleshooting guide · hammerspoon
Hammerspoon UI Not Showing in Full-Screen Apps
- Status
- Fixed in latest version
- platforms:
- macOS
- updated:
- November 16, 2026
- Method
- how we research
RUNBOOK · hammerspoon/no-ui-in-fullscreen1 FIX
// quick answer
Hammerspoon alerts and canvases do not appear over full-screen apps when the Dock icon is on. Turn the Dock icon off.
Most likely fix: Disable the Dock icon
How to fix it
// try these in order, the most common fix is first
FIX 1Disable the Dock icon
- 01Open Hammerspoon Preferences and untick Show dock icon
- 02Or add hs.dockIcon(false) to init.lua and reload
Did this fix it?
Symptoms
Alerts, chooser or canvas elements are invisible above a full-screen app.
Why it happens
- C-01Dock icon enabled
// this guide also covers
- hammerspoon fullscreen
- hammerspoon alert not showing
Still not working?
If Hammerspoon keeps failing, you're not alone. See every Hammerspoon problem users report or the alternatives people switch to.
Done fighting Hammerspoon? Our small team builds your own Hammerspoon alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usThe same problem in other apps
All missing or lost data guides →
Keyboard Maestro Macros Not Saving (Keyboard Maestro)
Other Hammerspoon errors
- Hammerspoon Accessibility Permission Not Working
- Hammerspoon Keystrokes Not Working
- Hammerspoon Hotkeys Stop Working
- Hammerspoon Timer or Watcher Stops Working
- Hammerspoon Modal Hotkeys Not Working
- Hammerspoon Cannot Find Application By Name
- Hammerspoon selectMenuItem Not Working From Console
- Hammerspoon v2: What Changes and Should You Wait