// troubleshooting guide · espanso
Espanso macOS Accessibility Permission Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · espanso/macos-accessibility-permission3 FIXES
// quick answer
On macOS, Espanso needs Accessibility permission. If it is set but nothing expands, remove and re-add the entry and restart Espanso.
Most likely fix: Re-grant permission
How to fix it
// try these in order, the most common fix is first
FIX 1Re-grant permission
- 01Open System Settings > Privacy & Security > Accessibility
- 02Remove Espanso with the minus button
- 03Run `espanso start` and add it again when prompted, switch it on
Did this fix it?FIX 2Restart the service
- 01Run `espanso restart`
- 02Run `espanso status` to confirm it is running
Did this fix it?FIX 3Follow the macOS install steps for the security warning
- 01Open the app once from Applications
- 02Approve it in Privacy & Security if blocked
Did this fix it?
Symptoms
Security warning on first start, or the permission appears on but Espanso does nothing.
Why it happens
- C-01Permission never granted
- C-02Entry stale after update or reinstall
- C-03Binary quarantined after download
// this guide also covers
- espanso accessibility permission
- espanso macos not working
- espanso sequoia
Still not working?
If Espanso keeps failing, you're not alone. See every Espanso 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