Keyboard typing double letters (key chatter)
A key that occasionally fires twice on one press is almost always switch chatter: a worn or dirty mechanical switch bounces on contact and the controller reads that bounce as two separate presses. It's usually fixable without new hardware, but you need to confirm which key does it and how often before you can trust a fix. Start with the live test, then work down the list below.
Step-by-step fix
- Understand the cause first: every mechanical switch's metal contacts can bounce for a fraction of a second when pressed, and firmware normally filters that out. Dust, wear, or a spring going soft can widen the bounce window past what the debounce filter catches, so one press registers as two.
- Prove it with the CheckMyMic keyboard test: press the suspect key slowly and repeatedly, one clean press at a time, and watch whether it lights up or logs twice per press. A key that's fine here but doubles while typing fast points to debounce timing rather than a dead switch.
- Pop the keycap off the offending key with a keycap puller and hit the exposed switch with a few short bursts of compressed air, holding the can upright to avoid propellant residue. Dust and skin oil under the stem are the single most common chatter cause.
- If the keyboard supports it, raise the debounce time in firmware. QMK and VIA boards expose a debounce setting (typically 5 ms by default) under the keyboard's configuration — nudging it up to 8–10 ms fixes chatter with almost no perceptible typing delay. Gaming-brand keyboards (Razer, Logitech, Corsair) expose the same idea inside their vendor software.
- On a keyboard with no debounce control, Windows' Filter Keys (Settings → Accessibility → Keyboard → Filter keys) can mask chatter by ignoring repeated keystrokes that arrive too quickly. It's a blunt instrument: set too aggressively, it also swallows fast legitimate typing, so treat it as a stopgap, not a fix.
- Retest after cleaning and any debounce change using the keyboard test above — repeat the slow-press check on the same key to confirm the doubling is actually gone, not just less frequent.
- Chatter that survives cleaning and a debounce increase means the switch itself has failed. On a hot-swap board, pull the switch and drop in a replacement; on a soldered board or one still under warranty, that's the point to contact the manufacturer instead of continuing to chase it in software.
Frequently asked questions
What exactly is key chatter?
It's a single key press being registered as two or more inputs because the switch's internal contacts bounce briefly when they touch. Firmware normally smooths this out with a short debounce delay, but a worn spring or dirty contacts can widen the bounce enough to slip past that filter.
Does compressed air actually fix chatter?
Often, yes — dust and oil buildup on the contacts is a common cause, and a burst of air under the keycap clears it without disassembling the switch. It won't help if the spring or contact metal has physically worn out, which is why you retest afterward rather than assuming it worked.
What debounce time should I set?
Most keyboards default to around 5 milliseconds. Raising it to 8–10 ms clears chatter on most affected switches while staying well below what a typist can perceive as delay. Go higher only if chatter persists, and retest with the key tester after each change.
I've tried everything and the key still doubles — what now?
Isolate the switch: if it's a hot-swap board, borrow a known-good switch from an unused key and drop it into the chattering position — if the doubling follows the old switch, it's confirmed dead and needs replacing or a warranty claim. Confirm before and after with the CheckMyMic keyboard test, and if the same keyboard also feels slow to respond, our keyboard input lag guide covers that separately.