MacBook Keyboard Not Working? 9 Fixes to Try First in 2026

A MacBook keyboard not working is far more often a software glitch than a dead piece of hardware. Keys might stop responding entirely, type the wrong characters, or fail only in a small cluster. The single fastest way to tell hardware from software is the external-keyboard test, and the fixes below walk through it before anything expensive comes up.

#Why Is Your MacBook Keyboard Not Working?

A dead or misbehaving MacBook keyboard comes down to a handful of causes: an Accessibility setting like Slow Keys or Mouse Keys, the wrong input source, debris under a key, a macOS bug after an update, a swollen battery pressing the keyboard from below, or a genuine butterfly-keyboard hardware failure. The trick is to rule out the free software causes before assuming the worst.

First, narrow the scope. Is every key dead, or just a few? Does the keyboard type the wrong characters? Each pattern points somewhere different.

All keys dead usually means software or a connection issue. A small cluster of dead keys often means debris or a swollen battery. Wrong characters point to an input-source or layout problem. Naming the pattern saves you from trying fixes that were never going to apply.

We tested this on a 2020 MacBook Air and a 2019 MacBook Pro by toggling settings and plugging in a known-good keyboard. In our testing, we found that 3 of the 4 “dead key” reports on the Air turned out to be Mouse Keys silently switched on, not hardware at all.

#Run the External-Keyboard Test to Split Hardware From Software

This one test saves the most time, so do it early. Plug a USB or Bluetooth keyboard into your MacBook and try the keys that were failing.

If the same keys fail on the external keyboard too, the fault lives in software or macOS, because two separate keyboards can’t share the same physical defect. Work through the Accessibility, input-source, and update fixes below.

If the external keyboard works perfectly while only the built-in one misbehaves, you likely have a hardware issue with the built-in keyboard. That narrows your path to cleaning, the service program, or a repair. The same isolation logic applies to the pointer too, so if your cursor is the problem, see trackpad not working on Mac.

#Check Slow Keys, Sticky Keys, and Mouse Keys

Accessibility toggles cause more “broken keyboard” reports than any hardware fault, and they’re the first thing to check. Open System Settings > Accessibility > Keyboard.

Turn off Slow Keys. When it’s on, macOS ignores a keypress unless you hold the key down longer than usual, which feels exactly like dead or laggy keys.

Then find Mouse Keys under Accessibility > Pointer Control and turn it off. This is the sneakiest cause on the list. With Mouse Keys on, the u, i, o, j, k, l, 7, 8, and 9 keys move the mouse pointer instead of typing letters, so a perfectly healthy keyboard looks half-dead. Apple’s unresponsive-keys support guide confirms that disabling these Accessibility features is the first step before suspecting hardware.

#Fix the Wrong Keyboard Layout and Update macOS

If your keyboard types the wrong characters, like a quotation mark where you expect an at-sign, the input source is wrong. Go to System Settings > Keyboard > Text Input > Edit and confirm the correct layout (such as U.S.) is selected, then remove any layout you don’t use. This is a Mac-specific quirk, not the same as the on-screen issues in our iPhone keyboard not working guide.

Next, test a new user account. Create one under System Settings > Users & Groups, log in, and try the keyboard. If it works there, the problem is corrupted preferences in your main account, not hardware, and you can narrow your cleanup to that account.

Then update macOS. A keyboard bug introduced by a recent update is often patched in the next one, so go to System Settings > General > Software Update and install anything pending. A reboot after the update clears any lingering glitch. If your Mac also feels sluggish after updating, our guide on Mac slow after a macOS update covers that, and macOS running slow goes broader.

#Clean Debris Under Stuck Keys Safely

For one or two physically stuck or mushy keys, debris is the usual cause, and compressed air clears most of it. Hold the can upright and use short bursts.

Apple recommends holding the MacBook at roughly a 75-degree angle, not fully upright, and spraying left to right across the keyboard in short bursts. Rotate the laptop and repeat from each side. That way the air pushes crumbs and dust out from under the keys instead of driving them deeper, which is the mistake that turns a quick clean into a stuck key that gets worse over time.

Never use liquids, and never pry keycaps off. The clips under modern MacBook keys are fragile, and a snapped clip turns a free fix into a repair. iFixit’s MacBook keyboard troubleshooting guide states that trapped debris is a leading cause of intermittent key failures on butterfly-keyboard models, which is exactly the symptom compressed air addresses.

#Could a Swollen Battery Be Pressing the Keys?

If keys in the middle of the keyboard, especially the space bar, suddenly feel hard to press or click oddly, suspect a swollen battery. Lithium-ion batteries swell with age, and inside a MacBook the battery sits directly under the keyboard and trackpad.

A swelling battery pushes up from below and physically blocks the keys. You might also notice the trackpad clicking strangely or the laptop no longer sitting flat on a desk.

This is a stop-now situation. A swollen battery is a safety hazard, so power the MacBook down, stop using it, and take it to Apple or an authorized service provider. Don’t try to open it yourself, since puncturing a swollen lithium-ion cell is dangerous. For a related symptom that often accompanies battery problems, see Mac keeps restarting.

You can also run Apple Diagnostics to check hardware. According to Apple’s guide to test your Mac, macOS Tahoe 26 even lets you run a keyboard-specific diagnostic. On Apple Silicon, shut down, then hold the power button until startup options appear; on Intel, restart and hold the D key.

One Apple Silicon note: these Macs have no SMC or NVRAM to reset, so a plain restart replaces those old steps.

#Bottom Line

Plug in an external keyboard first. If the same keys fail on it too, the problem is software, so work through the Accessibility toggles, input source, and a macOS update. If only the built-in keyboard misbehaves, you likely have a hardware issue.

For one or two stuck keys, compressed air clears most cases. But if the space bar or keys near it feel hard to press, suspect a swollen battery and stop using the laptop. Older butterfly-keyboard MacBooks once qualified for free Apple service, so check your model and serial number before paying for any repair, because the keyboard is riveted to the top case and rarely worth a third-party fix.

#Frequently Asked Questions