What causes chatter
Inside most mechanical switches, a key press brings two thin metal contacts together. Metal contacts never close perfectly cleanly: for a brief moment they bounce, connecting and disconnecting several times. Keyboard firmware handles this with debouncing, ignoring changes for a few milliseconds after the first contact so the bounce is read as a single press.
Chatter happens when a switch bounces for longer than that window, or makes intermittent contact while held down. The keyboard sees two presses and types the character twice. The usual causes:
- Dust or debris on the contacts, which interrupts the connection.
- Oxidation, a thin film on the contact surfaces, more likely in humid environments or after spills.
- Wear from heavy use, which changes the contact pressure.
- Manufacturing defects, which is why chatter sometimes appears on new keyboards.
- A loose hot-swap socket or bent pin, which can cause intermittent contact.
Confirm it before fixing
Not every double letter is chatter. Fast typists sometimes double a key themselves, and operating system settings can repeat keys. Chatter has a signature: the second press arrives far faster than a human can tap. Deliberate double taps are almost always more than about 80 ms apart; a repeat under 45 ms is almost certainly the switch.
The key chatter test on this site flags any same-key repeat under 45 ms and shows per-key statistics. Press the suspect key normally 20 to 30 times, then type a paragraph to see whether other keys are affected. If the test shows fast repeats on one key, it is chatter. If it shows nothing but you still see doubled letters in documents, check your software instead (see below).
Fixes, in order
- Clean around the switch. Pull the keycap and blow compressed air around the switch from several angles. See how to clean a mechanical keyboard.
- Exercise the switch. Press the key rapidly 50 to 100 times. This can wipe light dust or oxidation from the contacts. Retest.
- Contact cleaner. A small amount of electronics contact cleaner worked into the switch (on hot-swap boards, easier with the switch removed and opened), followed by more presses, often fixes oxidized contacts. Let it evaporate fully before use.
- Raise the debounce time. Some keyboards let you change debounce in their software, and boards running QMK can change it in firmware. A slightly longer debounce can hide mild chatter. It is a workaround, not a cure. See QMK and VIA explained.
- Replace the switch. On a hot-swap board, pull it and fit a new one; see how to swap switches. On a soldered board, the switch has to be desoldered, or you can remap the key elsewhere if the board supports it.
When it is not the switch
- Keyboard repeat settings: a very short repeat delay makes held keys repeat quickly. Check your operating system's keyboard settings.
- Remapping and macro software: tools such as AutoHotkey or vendor utilities can send extra keystrokes.
- Accessibility settings: Filter Keys on Windows changes how repeats are handled; check it is configured as you expect.
- Wireless interference: on some wireless keyboards, a poor connection can cause stuck or repeated keys. Try the cable or move the receiver closer.
Can you prevent it?
Keeping the keyboard clean and away from drinks helps. Switches without metal contacts, such as optical and Hall effect switches, avoid this failure mode altogether; see optical vs mechanical switches. On any MX-style board, choosing hot-swap means a chattering switch is a one-minute fix rather than a soldering job.
Frequently asked questions
Why is my keyboard typing letters twice?
Usually key chatter: the switch contacts bounce or make poor contact, and the keyboard reads one press as two. Dust, oxidation and wear are the common causes. Less often, the operating system's key repeat settings or a remapping tool are responsible. The chatter test shows which keys double fire and how far apart the presses are.
Can key chatter fix itself?
Sometimes, if it was caused by dust. Blowing out the switch and pressing the key rapidly many times can clear it. Chatter caused by worn or oxidized contacts usually gets worse over time rather than better.
How do I fix key chatter on a mechanical keyboard?
In order: clean around the switch with compressed air, press the key rapidly 50 or more times, try electronics contact cleaner, raise the debounce time if your firmware allows it, and replace the switch. On a hot-swap board, replacing the switch takes a minute.
Is key chatter covered by warranty?
Often, since it is a switch fault rather than damage. Run the chatter test, save the results, and contact the manufacturer with them, especially if the keyboard is new.