// troubleshooting guide · bettertouchtool
BetterTouchTool Trackpad Gestures Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · bettertouchtool/trackpad-gestures-not-working3 FIXES
// quick answer
If trackpad gestures never trigger, check permissions, conflicting macOS gestures and the trigger itself; fresh installs can need a permission reset.
Most likely fix: Turn off conflicting macOS gestures
How to fix it
// try these in order, the most common fix is first
FIX 1Turn off conflicting macOS gestures
- 01System Settings > Trackpad
- 02Disable the same swipe or tap gesture there
Did this fix it?FIX 2Reset permissions
- 01Remove and re-add BTT in Accessibility
- 02Restart BTT
Did this fix it?FIX 3Test with the latest build
- 01Update BTT or try the alpha
Did this fix it?
Symptoms
A gesture you set does nothing, even after a clean reinstall with permissions granted.
Why it happens
- C-01System gestures in macOS use the same swipe
- C-02Missing permissions
- C-03Wrong trackpad device selected
- C-04Bug in a specific gesture such as thumb-and-three-finger pinch
// this guide also covers
- bettertouchtool trackpad gestures not working
- bettertouchtool gestures not working after reinstall
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 usOther 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