MacBook Keyboard Not Working — Fix Guide

What Does This Error Mean?

MacBook keyboard not working is most often caused by a software issue that resolves with a restart, or a macOS accessibility setting (Slow Keys, Mouse Keys) accidentally activated. On MacBook Pro models with the butterfly keyboard (2016–2019), a stuck or dusty key is a known hardware issue.

Affected Models

MacBook Air (all models)
MacBook Pro (all models)
MacBook (2015–2019)

Common Causes

macOS accessibility feature enabled — Slow Keys or Mouse Keys disabling normal keyboard input
External Bluetooth keyboard conflict — macOS routing input to a paired external keyboard
Liquid spill — even minor moisture can cause key failure or ghosting
Butterfly keyboard mechanism failure (2016–2019 MacBook Pro) — Apple's keyboard replacement programme covers these
macOS kernel extension crash — rare but can freeze keyboard input until restart

How to Fix It

Restart the MacBook.

A kernel crash or stuck system service can prevent keyboard input from being processed. Restarting resolves most sudden keyboard failures. Use the Apple menu → Restart, or hold the power button for 10 seconds if the Mac is completely unresponsive.
Check Accessibility settings for Slow Keys or Mouse Keys.

Go to System Settings → Accessibility → Keyboard → Slow Keys — ensure it is off. Also check System Settings → Accessibility → Pointer Control → Alternate Control Methods — ensure Mouse Keys is off. Both features can make the keyboard appear not to respond.
Disconnect all external Bluetooth keyboards.

If an external Bluetooth keyboard is paired and active, some macOS versions route all input to it and ignore the built-in keyboard. Go to System Settings → Bluetooth and disconnect any paired keyboards.
Check for liquid damage.

Even a small amount of liquid between keys can cause keys to stick, double-type, or fail entirely. If a recent spill occurred, power off the MacBook immediately, turn it upside down, and do not power it on for at least 48 hours. Then take it to Apple for assessment.
Boot into Safe Mode and test the keyboard.

Restart and hold Shift (Intel) or hold the power button and select Safe Options → continue holding Shift (Apple Silicon). If the keyboard works in Safe Mode, a third-party app or extension is causing the issue in normal mode.

When to Call a Professional

MacBook Pro models from 2016–2019 with the butterfly keyboard have a known defect covered by Apple's Keyboard Service Programme. Take the MacBook to Apple or an AASP — the repair is free regardless of warranty status.

Frequently Asked Questions

Is the MacBook butterfly keyboard replacement still free?

Apple's Keyboard Service Programme for 2015–2019 MacBook and MacBook Pro butterfly keyboards is still active. Take the Mac to Apple Retail or an Apple Authorised Service Provider with no cost, regardless of AppleCare status.

Can I use a USB keyboard while my MacBook keyboard is broken?

Yes. Plug in any USB keyboard (or use a USB-C adapter) and it will work immediately in macOS without any setup. This is a reliable workaround while waiting for repair.