Debris Under the Keys
Crumbs and dust stop keys travelling properly. In fact, this is the main reason butterfly keys stick or repeat.

MacBook Guide
A MacBook keyboard not working can be anything from a single sticky key to a keyboard that ignores every press. The good news is that many cases are caused by a macOS setting, a crumb under a key or a system glitch that a restart clears. This guide covers MacBook Air and MacBook Pro models, including the butterfly keyboards from 2016 to 2019, and explains when the keyboard needs a repair.
Read the Clues
Start by working out how much of the keyboard is affected. A single key that sticks, repeats or does nothing is usually debris or a worn switch. However, if several keys in one area fail together, a spill or a damaged keyboard is more likely.
If the whole keyboard has stopped, connect a USB or Bluetooth keyboard. If that works, macOS is fine and the built in keyboard is the problem. In addition, an external keyboard lets you sign in while you troubleshoot.
Also check the trackpad. On many MacBooks the keyboard and trackpad share the same connection. Therefore, if both stop at once, a cable or board fault becomes more likely than a keyboard setting.
Typing two letters for one press is a classic butterfly keyboard symptom, often caused by dust under the key.
If keys only respond when held, Slow Keys is probably switched on in Accessibility settings.
One key stuck. Debris or worn switch.
Letters doubling. Typical butterfly keyboard fault.
Keyboard and trackpad dead. Cable or board issue.
Keys slow to respond. Slow Keys switched on.
First Steps
These quick checks fix many MacBook keyboard problems without any tools.
Choose Restart from the Apple menu. This reloads the keyboard driver and clears many temporary faults.
Open System Settings, then Accessibility, then Keyboard, and switch off Slow Keys. Then check Pointer Control and switch off Mouse Keys, which can take over some keys.
Open System Settings, then Keyboard, then Input Sources. Make sure the right layout is selected, because the wrong one moves symbols around.
Hold the MacBook at a 75 degree angle and spray compressed air across the keys in a left to right motion, as Apple recommends. Then rotate it and repeat from each side.
System Resets
If the quick checks have not worked, these resets clear deeper glitches. They do not touch your files.
On Apple silicon, shut down, hold the power button until the options appear, select your disk, then hold Shift and click Continue in Safe Mode. On Intel, hold Shift while starting. If the keyboard works in Safe Mode, a third party app or login item is the cause.
On Intel MacBooks with the T2 chip, shut down, then hold Control, Option and Shift for seven seconds, add the power button and hold all four for another seven seconds. Apple silicon models do not need this, because a restart does the same job.
Shut down, then turn on and immediately hold Option, Command, P and R for about 20 seconds. This resets some keyboard and display settings.
Safe Mode on Intel Macs.
Apple Diagnostics on Intel Macs.
Apple Diagnostics from the startup options on Apple silicon.
Shows which keys macOS can detect.
Common Causes
These are the causes we find most often in MacBook Air and MacBook Pro keyboards.
Crumbs and dust stop keys travelling properly. In fact, this is the main reason butterfly keys stick or repeat.
Slow Keys or Mouse Keys has been switched on, so keys seem slow or stop typing letters.
A third party keyboard app or a stuck macOS process stops input. Safe Mode helps confirm this.
Even a few drops can stop keys or the trackpad. See our liquid spilled on laptop guide for what to do.
An ageing battery can swell under the keyboard, pushing keys up and making them stiff. This needs prompt attention.
Worn switches, a damaged flex cable or a board fault need a repair rather than a setting change.
macOS Tools
Several macOS settings can make a working keyboard seem faulty, so check them before assuming the worst.
In Keyboard settings, a very short delay makes keys seem to repeat. Move the slider towards Long and test again.
Keyboard Shortcuts, then Modifier Keys, can swap keys such as Command and Control. Restore the defaults if keys behave oddly.
Choose whether the top row controls brightness and volume or acts as F1 to F12. Changing this can make keys seem broken.
Prying off keycaps. Butterfly caps break very easily.
Spraying liquid cleaner. It can run under the keys.
Using a raised keyboard. It may be a swollen battery.
Charging after a spill. Switch off and get it checked.
Butterfly Keyboards
Apple used a very thin butterfly keyboard on the 12 inch MacBook from 2015, the MacBook Pro from 2016 to 2019 and the MacBook Air from 2018 to 2019. These keyboards are slim, but a single piece of dust can stop a key working or make it type twice.
Apple ran a keyboard service programme for these models, covering them for four years after the first retail sale. As a result, most of these MacBooks are now outside that programme. Even so, a repair is still worthwhile for many owners, because the rest of the laptop often works perfectly.
From the 16 inch MacBook Pro in late 2019, and across the range in 2020, Apple moved to the Magic Keyboard with scissor switches. These are far more reliable, so a fault on a newer MacBook is more likely to be liquid, wear or a cable.
Apple Diagnostics
macOS includes a Keyboard Viewer that shows each key light up as you press it. Turn it on in System Settings, then Keyboard, then Input Sources, by ticking Show Input menu in menu bar. Then choose Show Keyboard Viewer from the menu bar icon and press each key in turn.
Apple Diagnostics goes deeper and runs outside macOS. On Apple silicon, shut down, hold the power button until the startup options appear, then press Command and D. On Intel models, hold D while the MacBook starts. The test reports a reference code if it finds a hardware problem.
If the keyboard fails in both tests, it needs repair. On the other hand, if it passes, go back to the settings and Safe Mode steps, because the cause is software.
Repair Options
On most MacBook Air and MacBook Pro models, the keyboard is riveted into the top case along with the battery. Therefore, replacing it is a bigger job than on many Windows laptops, and the battery is often replaced at the same time.
However, a single key can sometimes be repaired on its own. If one key is broken but the rest work well, ask about replacing just that key and its switch, which costs much less.
Usually yes, if the rest of the MacBook is in good condition. See our MacBook repair versus Apple Store guide to compare options.
Signing In
If the keyboard stops at the login screen, connect a USB or Bluetooth keyboard and sign in with that. In addition, macOS can show an on screen keyboard at login if the Accessibility Keyboard was turned on beforehand.
Once you are signed in, go through the settings and Safe Mode steps above. If the built in keyboard works in Safe Mode, remove recently installed keyboard or text expansion apps, because they are a common cause.
Prevention
A few simple habits prevent most keyboard problems.
Crumbs and spills cause most of the keyboard faults we see on MacBooks.
Use Apple’s compressed air method regularly, rather than waiting for a key to stick.
This keeps dust out of the keys, especially in a busy household.
Check battery health in System Settings. A worn battery should be replaced before it swells under the keyboard.
Getting Help
If cleaning and the resets have not helped, or Apple Diagnostics reports a fault, the keyboard, its cable or the board needs attention. Equally, any keyboard that has become raised or stiff needs checking straight away because of the battery risk.
Our MacBook repair Melbourne service tests the keyboard, battery and board and gives you a quote before any work starts. For general keyboard problems, see our laptop keyboard repair page.
Model and year. From About This Mac.
Which keys fail. One, several or all.
Any spill. And how long ago.
Trackpad playing up? See touchpad and trackpad repair.
Common Questions
Quick answers for MacBook Air and MacBook Pro owners.
Debris under the keys is the most common cause, especially on butterfly keyboards. Clean with compressed air at a 75 degree angle, then restart.
This is a known butterfly keyboard fault caused by dust. Cleaning sometimes helps, but a worn switch may need replacing.
Restart first. On Intel models, reset the SMC and NVRAM. On Apple silicon, a full shutdown and restart does the same job.
When both fail together, a cable, liquid damage or a board fault is likely. Try Safe Mode and Apple Diagnostics, then get it checked.
The programme covered butterfly keyboards for four years after sale, so most affected models are now outside it.
It depends on the model and whether parts are in stock. A single key is often quick, while a full top case takes longer.
Summing Up
In many cases, a MacBook keyboard not working is caused by debris, an accessibility setting or a software glitch. Restart, check Slow Keys and Mouse Keys, clean with compressed air and try Safe Mode. On Intel models, reset the SMC and NVRAM too.
If the keyboard fails Apple Diagnostics, or several keys stopped after a spill, it needs repair. At that point, a technician can confirm the fault and quote the work before anything is done.
Call us and we will help you find out whether it is a setting, debris or the keyboard itself.