// troubleshooting guide · raycast
Raycast Window Management Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · raycast/window-management-not-working3 FIXES
// quick answer
Window management needs Screen Recording permission; toggle it, update Raycast after OS updates.
Most likely fix: Grant permission
How to fix it
// try these in order, the most common fix is first
FIX 1Grant permission
- 01System Settings > Privacy & Security > Screen Recording
- 02Enable Raycast; toggle off/on if stuck
Did this fix it?FIX 2Update Raycast
- 01Run Check for Updates
Did this fix it?FIX 3macOS 26 menu bar
- 01System Settings > Menu Bar > Allow in the Menu Bar
Did this fix it?
Symptoms
Window commands do nothing or Space switching misbehaves.
Why it happens
- C-01Screen Recording permission missing
- C-02macOS update bug fixed in later Raycast release
// this guide also covers
- raycast window management not working
- raycast window snapping
Still not working?
If Raycast keeps failing, you're not alone. See every Raycast 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