// troubleshooting guide · hyperkey
Hyperkey Not Working on Mac
- Status
- Ongoing
- platforms:
- macOS
- updated:
- November 18, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · hyperkey/not-working3 FIXES
// quick answer
Hyperkey usually stops working because another remapper captures Caps Lock, Caps Lock's macOS modifier action was changed, or permissions are missing. Check those first, then update the app.
Most likely fix: Quit other remapping tools
How to fix it
// try these in order, the most common fix is first
FIX 1Quit other remapping tools
- 01Quit Karabiner-Elements and BetterTouchTool (or disable their Caps Lock rules)
- 02Test Hyperkey again
Did this fix it?FIX 2Reset Caps Lock in macOS
- 01Open System Settings > Keyboard > Keyboard Shortcuts > Modifier Keys
- 02Set Caps Lock Key to Caps Lock
- 03Retest
Did this fix it?FIX 3Re-grant permissions and update
- 01Open System Settings > Privacy & Security and check Accessibility and Input Monitoring for Hyperkey
- 02Toggle the permission off and on, then restart Hyperkey
- 03Download the latest version from hyperkey.app
Did this fix it?
SANDBOX · hyperkey RUNS IN YOUR BROWSER
Try it: build a workflow, map fields, turn it on and watch the usage meter
A hands-on Hyperkey-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Holding Caps Lock does nothing or acts as plain Command; shortcuts bound to the hyper combination do not fire.
Why it happens
- C-01Another remapper (Karabiner-Elements, BetterTouchTool) is capturing the key
- C-02Caps Lock's modifier action in macOS was changed
- C-03Missing Accessibility or Input Monitoring permission
- C-04Outdated Hyperkey version
// this guide also covers
- hyperkey not working
- hyper key mac not working
- hyperkey stopped working
Still not working?
If Hyperkey keeps failing, you're not alone. See every Hyperkey problem users report or the alternatives people switch to.
Done fighting Hyperkey? Our small team builds your own Hyperkey alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to us