// troubleshooting guide · bettertouchtool

BetterTouchTool Trackpad Gestures Not Working

Status
Workaround available
platforms:
macOS
updated:
November 16, 2026
reports:
3
Method
how we research
Share

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

  1. FIX 1Turn off conflicting macOS gestures

    1. 01System Settings > Trackpad
    2. 02Disable the same swipe or tap gesture there
    Did this fix it?
  2. FIX 2Reset permissions

    1. 01Remove and re-add BTT in Accessibility
    2. 02Restart BTT
    Did this fix it?
  3. FIX 3Test with the latest build

    1. 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 us

Watch BetterTouchTool Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other BetterTouchTool errors

All 11 BetterTouchTool errors and fixes →