Fix unresponsive keys

An unresponsive key can be a software mapping issue, a dirty switch, a loose connection, or a damaged switch. Work through the cheap and reversible steps before opening anything.

Try these in order

1. Retest in a text editor and in the keyboard test workspace. If the key works in one surface but not another, suspect software or a shortcut mapping.
2. Check the physical connection: unplug a USB keyboard, wait a moment, and plug it back in. On a laptop, restart the computer so the firmware can rescan.
3. Clean around the keycap with compressed air and a soft brush. Dust and debris can stop a switch from seating fully.
4. Look for a driver or firmware update from the keyboard manufacturer before assuming hardware failure.
5. Remap the key temporarily with the operating system’s built-in remapping tools to confirm the switch still reports.

If a hot-swappable keyboard has a removable switch, reseat that switch after turning the keyboard off. If none of these steps changes the result, the switch or the board likely needs service.

Keep a record of the exact keys that fail, whether they fail on keydown, keyup, or both, and whether they fail alone or only in a combination. That record is more useful than a guess about the cause.