// troubleshooting guide · hyperkey
Hyperkey Caps Lock Light and Quick Press Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 18, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · hyperkey/caps-lock-light-not-working2 FIXES
// quick answer
With quick press set to Caps Lock, the LED lights only on a quick tap and stays off on a long press, which is the intended behavior since a 2021 fix. Check quick press settings if Caps Lock does not toggle.
Most likely fix: Enable quick press
How to fix it
// try these in order, the most common fix is first
FIX 1Enable quick press
- 01Open Hyperkey from the menu bar
- 02Turn on the quick press option for Caps Lock
Did this fix it?FIX 2Check macOS modifier setting
- 01System Settings > Keyboard > Keyboard Shortcuts > Modifier Keys
- 02Set Caps Lock Key to Caps Lock (No Action also works but keeps the LED off)
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
Caps Lock LED does not light, or Caps Lock does not toggle on tap.
Why it happens
- C-01Quick press Caps Lock not enabled
- C-02Caps Lock set to No Action in macOS
- C-03Conflict with another remapper
// this guide also covers
- hyperkey caps lock light
- hyperkey quick press caps lock
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