// troubleshooting guide · bettertouchtool

BetterTouchTool Keyboard Shortcuts Not Working

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

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

  1. FIX 1Re-grant permissions

    1. 01Remove and re-add BTT under Accessibility and Input Monitoring
    Did this fix it?
  2. FIX 2Check for conflicts

    1. 01System Settings > Keyboard > Keyboard Shortcuts
    2. 02Quit other remapping tools and retest
    Did this fix it?
  3. FIX 3Check app scope

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

The same problem in other apps

All audio, video & device problems guides →

Other BetterTouchTool errors

All 11 BetterTouchTool errors and fixes →