Every switch in the keyboard sent a clean keydown signal. The build is electrically complete — all switches are seated correctly, all solder joints are making contact (on soldered boards), and no switch was installed backwards.
That specific switch didn’t register. On a hot-swap board, the switch may not be fully seated — the two pins must be centered and fully pushed into the hot-swap socket. A pin that’s even slightly bent won’t make contact. Pull the switch, straighten any bent pins, and reseat it. On a soldered board, a dark key after soldering points to a cold solder joint or a missed pad. Reflow the joint with a soldering iron and retest. If the pad itself is damaged, a wire bridge from the switch pin to the nearest trace point fixes it.
The switch tester confirms electrical registration only. A switch that registers every press but feels scratchy has debris or lacks lubrication — that’s a physical issue the tester can’t detect. Lube the switch or replace it if the feel is unacceptable, even though it passes the electrical test.
When to use the keyboard switch tester
After a full keyboard build: Every new build needs a switch test before keycaps go on. Installing keycaps over an untested switch and discovering a dead key afterward means pulling all the keycaps off again. Test first — cap second.
After a hot-swap session: Hot-swap sockets grip switch pins under spring tension. If a pin bends during installation, the socket contacts won’t close properly and the switch won’t register. The keyboard switch tester catches this in seconds — press the key, check the color, move on.
After replacing a single switch due to chatter: Once you’ve replaced a chattering switch, confirm the replacement registers cleanly before testing for chatter. A switch that doesn’t register at all is a seating problem. A switch that registers twice is a chatter problem. Test registration first with this tool, then confirm clean debouncing with the keyboard chatter test.
Before a warranty claim: A complete switch test log showing specific keys that don’t register is cleaner evidence for a warranty claim than a description of the problem. Screenshot the results with red-flagged keys visible.
What causes a switch to fail the registration test?
Bent pins (hot-swap boards): Hot-swap sockets are tight by design — that tension holds the switch securely. But it also means a pin that’s even 2–3 degrees out of alignment won’t enter the socket straight. The pin bends instead of seating. Pull the switch, use a flat surface to straighten the pins to exactly 90 degrees, and reseat. This is the most common failure on hot-swap keyboards.
Cold solder joint (soldered boards): A cold joint forms when the solder didn’t flow properly around both the switch pin and the PCB pad. Visually, cold joints look dull or grainy rather than shiny. Reheat the joint for 2–3 seconds with a clean iron tip and let fresh solder flow — the key will register on the next test.
Switch installed backwards: A few switch types — primarily Alps and some Kailh variants — can be physically inserted in the wrong orientation and still sit flush in the PCB. The switch looks correct but the contact legs hit the wrong pads. Check the switch orientation against the PCB silkscreen markings before soldering or seating.
Damaged hot-swap socket: Hot-swap sockets have a finite insertion cycle count — typically 50–100 swaps before the contact tension weakens. A socket that’s been hot-swapped many times may no longer grip the switch pin tightly enough to maintain electrical contact. If reseating the switch doesn’t fix a dark key, the socket itself may need to be replaced — a job for a soldering iron and a replacement socket.
Hot-swap vs. soldered — does the test work differently?
The keyboard switch tester works identically on both keyboard types — it only reads keydown events from the browser, regardless of how the switch is connected to the PCB. The difference is in what you do when a key fails.
| Scenario | Failed key fix | Time required |
|---|---|---|
| Hot-swap — bent pin | Pull switch, straighten pin, reseat | 2 minutes |
| Hot-swap — weak socket | Replace socket with soldering iron | 15–20 minutes |
| Soldered — cold joint | Reflow solder joint | 5 minutes |
| Soldered — missing solder | Add solder to dry pad | 5 minutes |
| Soldered — damaged pad | Wire bridge to nearest trace | 20–30 minutes |
On hot-swap boards, every fix is a pull-and-reseat. On soldered boards, every fix requires a soldering iron. The test result is the same either way — a dark key that should be green.
Pull the switch out completely and inspect the two pins — they should be perfectly straight and parallel. Reinstall the switch, pressing firmly and evenly until you feel it fully click into the hot-swap socket. Retest. If the key still doesn’t register after a clean reinstall with straight pins, the switch itself is faulty or the socket is damaged.
Yes — this is one of the best pre-purchase tests for used mechanical keyboards. Press every key and look for any that don’t turn green. Pay particular attention to the spacebar, Enter, Shift keys, and the bottom row — those get the most wear. Combine this with the keyboard chatter test to check for worn switches that register but double-fire.
The test works on any keyboard — it reads keydown events regardless of switch type. Membrane keyboards fail this test the same way mechanical ones do: a key that doesn’t register appears dark. The fix is different — membrane keyboards use a rubber dome and conductive membrane layer, and failures usually mean a torn membrane, not a replaceable switch.
Intermittent registration is a common symptom of a dirty or oxidized switch contact. The contact makes connection on the first press, then debris shifts and blocks the next press. Compressed contact cleaner sprayed into the switch resolves most intermittent failures. If cleaning doesn’t help, replace the switch. Run the switch tester again after cleaning to confirm the fix held.