// troubleshooting guide · bettertouchtool
BetterTouchTool Keyboard Shortcuts Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · bettertouchtool/keyboard-shortcuts-not-working3 FIXES
// quick answer
Shortcuts and key sequences can stop after an update or hours of uptime. Check permissions, restart BTT and look for conflicts with other tools.
Most likely fix: Re-grant permissions
How to fix it
// try these in order, the most common fix is first
FIX 1Re-grant permissions
- 01Remove and re-add BTT under Accessibility and Input Monitoring
Did this fix it?FIX 2Check for conflicts
- 01System Settings > Keyboard > Keyboard Shortcuts
- 02Quit other remapping tools and retest
Did this fix it?FIX 3Check app scope
- 01Make sure the preset is for Global or the right application in BTT
Did this fix it?
Symptoms
A configured shortcut or key sequence does not fire while trackpad gestures may still work.
Why it happens
- C-01Lost Accessibility or Input Monitoring permission
- C-02Shortcut conflicts with macOS or other apps
- C-03Preset set to a different app than the front one
// this guide also covers
- bettertouchtool keyboard shortcut not working
- bettertouchtool key sequence not working
Still not working?
If BetterTouchTool keeps failing, you're not alone. See every BetterTouchTool 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 usThe same problem in other apps
All audio, video & device problems guides →
Keyboard Maestro Macros Not Firing (Keyboard Maestro)
Karabiner-Elements Not Working on MacBook Keyboard (macOS Tahoe 26.4+) (Karabiner-Elements)
Other BetterTouchTool errors
- BetterTouchTool Not Working After macOS Update
- BetterTouchTool Accessibility Permission Not Working
- BetterTouchTool Gestures Stop Working After Sleep
- BetterTouchTool Is Currently Disabled Error
- BetterTouchTool High CPU Usage
- BetterTouchTool High Memory Usage
- BetterTouchTool Blocks Keyboard and Mouse Clicks
- BetterTouchTool Window Snapping Not Working