MacBook guide
MacBook Keyboard Not Working? Diagnose the Pattern
Use the pattern of failed MacBook keys to identify debris, liquid, settings or hardware issues.
One failed key and an entire unresponsive row often have different causes. Recording exactly what fails helps make diagnosis faster.
What the symptoms can mean
Sticky individual keys may involve debris or mechanical wear. Multiple keys, backlight faults or failures after a spill can indicate a cable or top-case problem.
What to do next
Restart the Mac, test in another app and check keyboard settings. Avoid spraying cleaner beneath the keys. After liquid exposure, switch off and disconnect power.
How keyboard faults are traced
Diagnosis follows the pattern: a single dead key usually means debris or a worn mechanism under that cap; a whole row or column points to the keyboard ribbon cable or its connector; everything failing at once after a spill suggests corrosion on the board. The keyboard is also tested with an on-screen viewer so software settings can be ruled out before any hardware is touched.
Repair options by model
On many MacBooks the keyboard is part of the top case, so a failed keyboard is replaced as a complete unit with the battery included; on others, individual key mechanisms can be serviced. Either way, the work involves separating the top case and handling the battery safely. An external keyboard is a fine stopgap, but it does not fix the underlying fault.
When to arrange a diagnosis
If the problem continues after safe basic checks, a proper diagnosis is the best next step. It helps separate a replaceable part from a deeper board, power or software issue before any repair is approved.
Common questions
Can a single key be replaced?
On some models yes — the mechanism and cap can be serviced individually. On others the keyboard comes as part of the top case, so the repair is larger. The model determines the approach.
Why did keys stop working after a small spill?
Even a few drops wick under the keycaps and corrode the membrane and connector. Power the Mac off and have it inspected before the corrosion spreads.
