MacBook keyboard not working Featured Image

MacBook keyboard not working? Steps To Fix it(2026)

by

MacBook keyboard not working stops everything cold.
You cannot log in. You cannot type a command. You cannot respond to a message.
And because the MacBook keyboard is built directly into the chassis —
not a peripheral you can swap in 30 seconds — the usual fix of
“just replace it” does not apply here. You need to know exactly
what broke and exactly how to fix it.

The good news is that the majority of MacBook keyboard failures are not
hardware deaths. They are software freezes, firmware corruption,
accessibility setting accidents, debris under a key switch,
or post-update driver conflicts — all of which are fixable without
opening the MacBook or spending a dollar. The bad news is that
applying the wrong fix to the wrong cause wastes hours and sometimes
makes the problem harder to diagnose correctly.

This guide eliminates that guesswork. It covers four specific MacBook
keyboard failure scenarios — keyboard dead with zero response,
individual keys failing while others work fine, keys typing the wrong
characters entirely, and keyboard failure appearing only after a macOS
update — with the precise cause and a step-by-step fix for each one.
Every fix is tested, specific, and sequenced from fastest to deepest
intervention.

One-line answers by scenario:

Dead keyboard — zero response: Force restart first,
SMC reset second — resolves the majority of total keyboard failures
in under three minutes with no data loss.

Individual keys not working: Compressed air at the
correct 75-degree angle — a single particle of debris under a butterfly
key is enough to kill it completely.

Wrong characters typing: Your Input Source switched
languages accidentally — one click in the menu bar restores correct output
instantly.

Failed after macOS update: NVRAM holds stale keyboard
configuration from the previous OS version — NVRAM reset clears it
without touching your files.

MacBook keyboard not working smc reset

MacBook Keyboard Not Working — Full Table of Contents

MacBook Keyboard Not Working — General
Causes and Fixes

Before identifying which specific scenario you are dealing with,
understanding the three layers where MacBook keyboard failures originate
saves significant time. The MacBook keyboard does not fail in one way.
It fails in three fundamentally different ways — hardware, firmware,
and software — and each layer requires a completely different approach.

Hardware failures involve physical components:
debris under a key switch, liquid contact with the membrane,
a broken key cap retainer, or a disconnected ribbon cable from
the keyboard assembly to the logic board. Hardware failures produce
consistent, repeatable symptoms — the same key fails every time,
in every application, in every user account, including in macOS Recovery.
Hardware failures do not resolve with software fixes.

Firmware failures involve the System Management Controller
(SMC) or NVRAM — the low-level firmware components that manage hardware
initialization and configuration. Firmware failures cause the keyboard
to fail at a level below the operating system — the MacBook may boot
normally and the display may work fine, but keyboard signals never reach
macOS because the firmware layer that manages hardware communication
is in an error state. Firmware failures resolve with SMC and NVRAM resets —
non-destructive procedures that take under 90 seconds.

Software failures involve macOS settings, keyboard
preference files, third-party input managers, or driver conflicts introduced
by an update. Software failures produce inconsistent symptoms — the keyboard
may work in some applications and fail in others, work in Safe Mode
but fail in normal mode, or work in a different user account but fail
in yours. Software failures resolve with targeted settings changes,
preference file deletion, extension removal, or macOS reinstallation.

Most Common Causes of MacBook
Keyboard Not Working

Debris beneath the butterfly key mechanism on 2016–2019 MacBook
models stops individual keys from completing their electrical contact.
Apple’s butterfly keyboard — used across MacBook, MacBook Air, and MacBook Pro
from 2016 to 2019 — reduced key travel to as little as 0.55mm.
At that travel distance, a single particle of debris sitting beneath
the key dome creates enough physical resistance to prevent the key
from completing its electrical contact with the membrane below.
The key feels normal or slightly stiff, but produces zero output.
Apple acknowledged this design problem publicly and created
a free Keyboard Service Program covering all affected models.
If your MacBook keyboard started failing key by key and your model
is from 2015 to 2019, this is the most likely cause.

A frozen or corrupted SMC halts keyboard signal routing
to macOS while the rest of the system appears normal.
The System Management Controller manages fundamental hardware
communication between physical MacBook components and the operating system.
When the SMC enters a corrupted state — from a power interruption,
an abrupt shutdown, a battery management event, or a software conflict —
it can stop forwarding keyboard signals to macOS entirely.
The MacBook boots, shows the desktop, responds to trackpad input,
and plays audio — but every keypress on the built-in keyboard
produces nothing. This looks exactly like hardware failure but resolves
completely with an SMC reset in under 60 seconds. It is the most
commonly misdiagnosed MacBook keyboard problem.

An accidentally switched Input Source remaps every physical
key to a different character, making the keyboard appear broken.
macOS stores keyboard layouts for dozens of languages,
each mapping physical keys to different output characters.
A keyboard shortcut — Control + Space or
Command + Space depending on settings — switches
between Input Sources with a single accidental keypress.
When the layout switches to French AZERTY, German QWERTZ,
or any other regional layout, every key produces different output
than the character printed on the physical key cap.
Most users interpret this as a keyboard malfunction rather than
a layout switch — and spend significant time troubleshooting
hardware when the fix is a single menu bar click.

A macOS update corrupts keyboard preference files or introduces
an incompatible third-party keyboard extension that blocks input.
macOS updates replace system files but leave user preference files intact.
If a preference file contains a value that is incompatible with
the new macOS version’s expected schema — particularly for keyboard
accessibility settings, input source configuration, or modifier
key remapping — the new macOS may apply that setting incorrectly,
causing persistent keyboard behavior changes that survive restarts.
Additionally, third-party keyboard utilities that worked on the previous
macOS version may load incompatible system extensions on the updated
kernel and crash or block keyboard input pipeline access entirely.

General Fixes — Try These First on Any
MacBook Keyboard Problem

Step 1 — Force restart the MacBook as the absolute first action
before any other troubleshooting.

Press and hold Power Button continuously for 10 full seconds →
MacBook shuts down hard →
Wait 30 seconds completely →
Press Power Button once to start →
Allow complete boot to desktop →
Open TextEdit immediately →
Test every row of keys systematically

The 10-second hold is mandatory — not 5 seconds, not 7.
A shorter hold may initiate a soft restart rather than a hard shutdown,
which does not terminate all active processes cleanly.
The 30-second wait after shutdown allows all capacitors to discharge
and all active processes to fully terminate before the restart cycle begins.
Test in TextEdit specifically — it is a native Apple application with
no third-party input processing that could mask keyboard behavior.

Step 2 — Verify Input Source and active keyboard layout
before any hardware investigation.

Look at menu bar → locate flag icon or language abbreviation
on right side →
If not visible: Apple Menu → System Settings → Keyboard →
Input Sources → Edit →
Confirm only one Input Source is present →
If multiple: remove all extras, keep primary language only →
Click Done → open TextEdit → test typing

This two-minute check rules out the most common cause of
wrong-character output. If you see a flag that does not match
your country, or a language code abbreviation you do not recognize,
that is your entire problem — click it and switch back.
Remove any extra Input Sources from the list permanently
to prevent accidental re-switching during fast typing sessions.

Step 3 — Check three Accessibility settings that silently
alter keyboard behavior.

Apple Menu → System Settings → Accessibility → Keyboard →
Slow Keys → confirm Toggle is OFF →
Sticky Keys → confirm Toggle is OFF →
Press Options next to Sticky Keys →
Uncheck "Press Shift five times to toggle Sticky Keys" →
Apple Menu → System Settings → Accessibility →
Pointer Control →
Mouse Keys → confirm Toggle is OFF →
Click Done

Slow Keys, Sticky Keys, and Mouse Keys each change keyboard behavior
in ways that feel like hardware failure. Slow Keys adds a delay before
any keypress registers — making the keyboard feel dead at normal
typing speed. Sticky Keys changes how modifier keys interact with
subsequent presses. Mouse Keys redirects keyboard input to control
the cursor, making most letter keys appear non-functional for typing.
Any of these can be enabled accidentally through keyboard shortcuts.
Unchecking the Shift-five-times shortcut for Sticky Keys prevents
it from reactivating accidentally during future sessions.

Step 4 — Plug in an external USB keyboard to determine
hardware versus software origin.

Connect any USB keyboard via USB-C adapter to MacBook →
Open TextEdit →
Type test sentence using external keyboard →
Attempt same test using built-in keyboard simultaneously →
Note whether responses differ between the two keyboards

This test produces a binary result that determines every subsequent
step. External keyboard works, built-in keyboard silent:
the problem is physical hardware — the built-in keyboard assembly,
its ribbon cable, or its membrane. Software fixes will not help.
Both keyboards fail or produce wrong characters: the problem is
macOS software — Input Source, accessibility settings, third-party
extensions, or preference file corruption. All remaining software
fixes will be effective. This distinction saves hours of misdirected effort.

Step 5 — Run Apple Diagnostics to check hardware integrity
before applying deeper fixes.

Shut down MacBook completely →
Apple Silicon MacBook (M1/M2/M3/M4):
Press and hold Power Button →
Continue holding until "Loading startup options" screen appears →
Press Command + D to launch Apple Diagnostics →
Intel MacBook:
Press Power Button →
Immediately press and hold D key →
Hold until Apple Diagnostics launches automatically →
Follow on-screen instructions →
Record any error codes shown at completion

Apple Diagnostics runs hardware verification tests and returns specific
error codes for keyboard-related failures. A clean diagnostic result
with no errors confirms keyboard hardware is physically intact —
directing all remaining investigation toward software and firmware.
Error codes beginning with “NDK” indicate keyboard controller faults.
Error codes beginning with “NDD” indicate issues with the keyboard
ribbon cable connection. Either result means hardware service is required
and further software troubleshooting will not resolve the problem.

Step 6 — Reset NVRAM to clear keyboard configuration
stored from previous macOS versions or corrupted entries.

Intel MacBook — NVRAM Reset:
Shut down completely →
Press Power Button →
Immediately hold Option + Command + P + R simultaneously →
Hold all four keys continuously for 20 full seconds →
Release all keys →
Allow MacBook to boot completely →
Reconfigure display resolution and time zone if prompted

Apple Silicon MacBook:
NVRAM is managed automatically by Apple Silicon →
Equivalent: shut down → wait 30 seconds → power on normally →
macOS reinitializes all hardware parameters on fresh boot

NVRAM stores keyboard-specific parameters: keyboard type identifier,
modifier key remapping, input source selection, and keyboard
initialization flags. A corrupted or incompatible value in NVRAM
persists through standard restarts because NVRAM is non-volatile
by design. The reset clears all hardware configuration parameters
and forces macOS to reinitialize them correctly from defaults.
Your files, applications, and user data are completely untouched.
After reset, macOS may ask you to confirm display resolution,
startup disk, and time zone — reconfigure these in System Settings
if needed.

Step 7 — Perform the correct SMC reset for your specific
MacBook model before any hardware investigation.

Identify your model: Apple Menu → About This Mac → Overview

MacBook with Apple Silicon (M1, M2, M3, M4 — any year):
Shut down → wait 30 seconds → power on
(Apple Silicon manages SMC functions automatically in firmware)

MacBook Pro/Air with T2 chip (Intel, 2018–2020):
Shut down →
Hold: Left Control + Left Option + Right Shift (7 seconds) →
While still holding: add Power Button →
Hold all four keys together for 7 more seconds →
Release everything → wait 5 seconds → press Power Button

MacBook Pro/Air without T2 chip (Intel, 2017 and earlier):
Shut down →
Hold: Left Shift + Left Control + Left Option + Power Button →
Hold all simultaneously for 10 seconds →
Release all → press Power Button to start

Using the wrong SMC reset procedure for your MacBook model
will not damage the hardware — but it also will not perform
the actual SMC reset. Confirm your chip generation in
About This Mac before proceeding. After the correct SMC reset,
allow the MacBook to complete a full boot without interruption.
Test the keyboard immediately after reaching the desktop,
before opening any third-party applications that might
introduce input managers or extensions.

Scenario 1 — MacBook Keyboard
Completely Dead, Zero Response

Zero keyboard response — no characters, no function key actions,
no modifier key behavior, complete silence from every key —
is the most alarming MacBook keyboard failure presentation.
It is also the one most likely to be a firmware issue rather
than hardware damage. An SMC freeze causes 100% identical symptoms
to a physically failed keyboard assembly. The MacBook boots normally.
The display is fine. The trackpad works. But every key on the built-in
keyboard produces absolutely nothing.

This distinction is critical because the fix for an SMC freeze
takes 60 seconds and costs nothing. The fix for a failed keyboard
assembly costs $300–$700 at Apple for out-of-warranty repair.
Ruling out SMC and firmware causes before concluding hardware failure
is not optional — it is the entire point of a systematic diagnostic
approach.

Also note whether the failure appeared suddenly — keyboard working,
then instantly dead with no warning — or gradually — one key failing,
then another, then another over days or weeks. Sudden total failure
strongly suggests firmware or software cause. Gradual progressive failure
strongly suggests physical degradation — debris accumulation on butterfly
keys, or progressive liquid damage spreading across the membrane contacts.

Why MacBook Keyboard Goes Completely Dead

SMC firmware freeze halts the entire keyboard signal chain
below the operating system level, producing total keyboard silence.
The SMC manages the hardware interface between the physical keyboard
assembly and the data path to macOS. When the SMC enters a frozen state —
triggered by abrupt shutdowns, power delivery interruptions,
battery management faults, or certain software conflicts during
system updates — it stops processing keyboard input signals entirely.
The keyboard itself is physically intact. Keys are pressing correctly.
The membrane is generating signals. But the SMC is not passing
those signals up the chain to macOS. The result is indistinguishable
from a dead keyboard assembly unless you test the SMC reset first.
Because SMC resets resolve this completely in 60 seconds,
they should always precede any hardware investigation for total keyboard failure.

A crashed HIDeventSystemClient daemon in macOS breaks the
input routing layer, blocking all keyboard signals from reaching applications.
macOS routes all human interface device input — keyboard, trackpad,
external mice — through a system daemon called HIDeventSystemClient.
If this daemon crashes or enters a deadlock state from a software conflict,
an incomplete application install, or a failed macOS update,
keyboard signals reach macOS but are not forwarded to the active
application or system processes. The keyboard hardware is generating
signals. The SMC is passing them to macOS. But the routing layer
between kernel and application is broken. A force restart terminates
and relaunches all system daemons including HIDeventSystemClient,
resolving this completely — which is why force restart is always
the first step before SMC reset.

Physical disconnection or partial seating of the keyboard
ribbon cable from the logic board causes total or intermittent failure.
The MacBook keyboard assembly connects to the logic board through
a thin ZIF (Zero Insertion Force) ribbon cable seated into a
locking connector. This cable can partially unseat from a significant
drop impact, from a repair that involved removing the bottom case
and was not reassembled with the ZIF connector fully locked,
or from material fatigue on older MacBook models where the connector
locking tab has degraded. A fully unseated cable causes complete keyboard
silence identical to an SMC freeze. A partially unseated cable causes
intermittent failures — keyboard works normally, then becomes
completely unresponsive, then works again — often triggered by
flexing the MacBook chassis slightly during use.

Complete liquid saturation of the keyboard membrane
creates multiple simultaneous short circuits that render
the entire keyboard unresponsive or erratic.
A significant liquid spill — coffee, water, juice — reaching
the full keyboard area does not always cause immediate total failure.
Initially, liquid may cause erratic behavior: keys typing phantom
characters, certain keys working and others failing,
or the keyboard appearing to function normally for minutes or hours.
As the liquid spreads through capillary action across the membrane
contacts and begins evaporating, it leaves electrically conductive
mineral and solute deposits on multiple key contacts simultaneously.
These deposits can create short circuits across the membrane
that force phantom keypresses, or insulating deposits that prevent
any key from registering. The progression from partial to total
failure after a liquid spill is characteristic and distinguishes
liquid damage from other total keyboard failure causes.

MacBook keyboard not working fixing scenerio

How to Fix MacBook Keyboard That Is
Completely Dead

Step 1 — Force restart to clear any frozen
input routing daemon.

Hold Power Button for 10 full seconds →
Release when MacBook powers off completely →
Count 30 seconds →
Press Power Button once →
Wait for complete boot to desktop (do not interrupt) →
Open TextEdit: Spotlight → type "TextEdit" → Return →
Test every key row: number row, QWERTY row, ASDF row,
ZXCV row, Space bar, Return, Delete

Test every row, not just one key. A frozen input daemon
causes total failure — after clearing it with a restart,
all keys should restore simultaneously.
If most keys restore but one or two remain non-functional,
the daemon was the primary cause but there may also be
a secondary physical issue with those specific keys.

Step 2 — Connect an external keyboard and test
to isolate hardware from software.

Connect USB keyboard via USB-C adapter →
Or pair Bluetooth keyboard:
System Settings → Bluetooth → put keyboard in pairing mode → Connect →
Open TextEdit →
Type using external keyboard → confirm it works →
Test every key on built-in keyboard →
Document which scenario applies:
External works + built-in dead = hardware problem
Both behave the same way = software problem

Do not skip this test. The result determines whether
the next 30 minutes of effort should be directed at
software fixes (preference deletion, Safe Mode, reinstall)
or hardware investigation (ribbon cable check, Apple service).
Spending 30 minutes deleting preference files on a
disconnected ribbon cable issue is wasted time.
This test takes four minutes.

Step 3 — Perform the correct SMC reset for your MacBook.

Apple Silicon (M1/M2/M3/M4 — all models):
Apple Menu → Shut Down →
Wait exactly 30 seconds →
Press Power Button

T2 Intel MacBook (Pro/Air 2018–2020):
Apple Menu → Shut Down →
Hold: Left Control + Left Option + Right Shift for 7 seconds →
Continue holding + add Power Button →
Hold all four for 7 more seconds →
Release all → wait 5 seconds →
Press Power Button to start

Non-T2 Intel MacBook (2017 and earlier):
Apple Menu → Shut Down →
Hold: Left Shift + Left Control + Left Option + Power Button →
Hold all simultaneously for 10 seconds →
Release → press Power Button

After performing the SMC reset, do not open any applications
for the first 60 seconds after reaching the desktop.
Let macOS initialize all hardware components cleanly
before introducing any application activity.
Then open TextEdit and test the full keyboard.
An SMC reset resolves complete keyboard non-response
in a significant percentage of cases where the failure
appeared suddenly without any physical cause.

Step 4 — Boot into macOS Recovery and test
keyboard in a clean firmware environment.

Apple Silicon Mac:
Shut down →
Press and hold Power Button →
Hold until "Loading startup options" text appears below Apple logo →
Select your startup volume →
Hold Shift key →
Click "Continue in Safe Mode" (if testing Safe Mode) →
Or select "Options" → Continue (for Recovery)

Intel Mac:
Restart →
Immediately hold Command + R →
Hold until Apple logo with progress bar appears →
Release when Recovery environment loads

Test: Click “Disk Utility” and try typing in the search field.
Or use Terminal from Utilities menu to test keyboard input.

macOS Recovery runs from firmware — completely independent
of your installed macOS. If your keyboard responds in Recovery
but not in normal macOS, the problem is definitively software:
a corrupted system file, a broken input manager,
or a preference file conflict that only exists in your installed OS.
If the keyboard also fails in Recovery, the problem is hardware
or firmware: the ribbon cable, the keyboard assembly,
or a deep SMC fault requiring Apple service.

Step 5 — Delete core keyboard preference files
to remove corrupted configuration data.

Open Finder →
Press Command + Shift + G →
Type exactly: ~/Library/Preferences/ →
Press Return →
Find and move to Trash:
com.apple.HIToolbox.plist
com.apple.keyboard.plist
com.apple.symbolichotkeys.plist
com.apple.universalaccess.plist →
Press Command + Shift + G again →
Type: /Library/Preferences/ (no tilde) →
Find and move to Trash:
com.apple.keyboard.plist (if present) →
Empty Trash →
Restart MacBook →
Test keyboard in TextEdit

Deleting both the user Library and system Library preference files
covers keyboard configuration at both the per-user level
and the system-wide level. macOS regenerates all four files
with correct defaults on the next boot. You will lose any
custom keyboard shortcut configurations — document them
before deleting if they matter. Standard keyboard behavior
restores immediately and completely from Apple defaults.

Step 6 — Create a new macOS user account to test
keyboard in a completely clean user environment.

Apple Menu → System Settings → Users & Groups →
Click Add Account (enter password when prompted) →
Account Type: Standard →
Full Name: Test User →
Password: any temporary password →
Click Create User →
Apple Menu → Log Out [current account] →
Log into Test User account →
Open TextEdit →
Test full keyboard

A new user account has no inherited preference files,
no third-party login items, and no user-specific
accessibility settings. If the keyboard works in the
new account but not your regular account, the problem is
entirely user-specific — a corrupted preference,
a user-installed input manager, or a user-level accessibility
setting that was not visible in System Settings.
Migrating to a fresh user account resolves this permanently.

Step 7 — Reinstall macOS via Recovery as the
final software resolution before hardware service.

Boot into Recovery:
Apple Silicon: Hold Power Button → Options → Continue
Intel: Restart → Hold Command + R

In Recovery:
Select “Reinstall macOS [version]” →
Click Continue →
Agree to license →
Select startup disk →
Click Install →
Allow 30–60 minutes to complete →
CRITICAL: Select Reinstall — NOT Erase Mac →
All personal data is preserved

A macOS reinstall replaces every system file with a clean,
verified copy — including any system keyboard driver or
input routing component that was corrupted. Your apps,
documents, photos, and settings are completely preserved.
If the keyboard remains dead after a clean macOS reinstall
on a Mac that shows no Apple Diagnostics error codes,
the final cause is a physical ribbon cable disconnection
that requires Apple service to access and reseat.

Scenario 2 — Individual MacBook
Keys Not Working or Physically Stuck

When specific keys stop working while the rest of the keyboard
functions normally, physical cause is the overwhelming likelihood.
Software and firmware failures almost always affect the entire
keyboard simultaneously — they do not selectively kill
the E key while leaving every other key functional.
One or two specific keys failing while twenty others work
perfectly points directly at something physical happening
at exactly that key location.

The most important piece of context here is your MacBook model year.
If you have a 2016, 2017, 2018, or 2019 MacBook with the butterfly
keyboard mechanism, individual key failures are extremely common —
Apple acknowledged the design flaw and created a free replacement program.
If you have a 2020 or later MacBook with the Magic Keyboard scissor mechanism,
individual key failures are less common but still happen from liquid residue,
physical key cap damage, or genuine switch wear on high-frequency keys.

Before applying any fix, identify exactly which keys are failing.
Open the macOS Keyboard Viewer — available from the Input menu in the
menu bar — and press each affected key while watching whether it
highlights in the Viewer. This single test tells you whether the
key is generating a hardware signal (highlights) that is not
reaching your application, or generating no signal at all (no highlight) —
which points directly at the physical key switch or debris beneath it.

Why Individual MacBook Keys Stop Working

A single debris particle under the butterfly switch
prevents the key from completing its electrical contact with the membrane.
The butterfly key mechanism operates at a key travel of 0.55mm —
a distance so small that a single grain of sand, a microscopic
food crumb, or accumulated skin cell debris at the key contact point
creates enough physical obstruction to prevent full key travel.
When the key cannot travel the full 0.55mm, it does not complete
the electrical connection with the membrane switch beneath it.
The result is a key that may feel mechanically normal,
slightly stiff, or subtly different — but produces no output character.
The keys most frequently affected are high-frequency ones:
E, T, Space bar, A, Return, and O. These are also the keys
closest to where users rest their hands during typing,
making them most exposed to skin-derived debris accumulation.

Dried liquid residue on a specific key contact creates
a localized insulating deposit that blocks electrical continuity
at that key only.
When a liquid spill reaches the keyboard membrane and is not
immediately cleaned correctly, it evaporates and leaves behind
dissolved minerals and solutes directly on the key contacts.
Tap water leaves calcium and magnesium salt deposits.
Coffee and tea leave sugar, acid, and caffeine compounds.
Juice and soft drinks leave concentrated sugar residues.
These deposits are electrically insulating at the concentrations
that form on key contacts, preventing the contact from closing
cleanly when the key is pressed. The failure is localized to
the exact key position where the liquid pooled and evaporated —
which is why liquid-damaged keyboards often show a pattern
of failed keys matching the direction the liquid spread
and where it settled by gravity.

A broken or separated key cap retainer prevents
the key from physically actuating the switch beneath it.
MacBook key caps are held in place by a retainer mechanism —
butterfly-shaped on 2016–2019 models, scissor-shaped on 2020+ models.
These retainer mechanisms are plastic and can fracture from impact,
from aggressive key cleaning attempts, from attempting to pry
a key cap off without releasing the retainer correctly,
or from material fatigue after years of repetitive flex.
When a retainer breaks, the key cap sits loose on the keyboard surface —
it may feel wobbly or sink differently than adjacent keys —
but cannot transfer pressing force to the membrane switch below.
A broken retainer is a visual inspection finding:
look at the key from the side under good lighting and
you can see it sitting higher or at an angle compared to
neighboring keys.

Membrane switch wear at a high-frequency key position
causes permanent loss of electrical conductivity at that specific contact.
Every MacBook key switch membrane has a rated actuation life.
Keys pressed thousands of times per day — Space bar, Return, E,
T, Backspace — accumulate far more actuations than less-used keys
on a heavily used MacBook over several years. When the conductive
coating on a membrane contact wears through at a high-frequency
position, that specific key permanently stops registering input.
The key feels mechanically correct when pressed — the mechanism
moves, the key travels — but no electrical contact occurs beneath.
This failure type cannot be resolved with cleaning, compressed air,
or software fixes. It requires keyboard assembly replacement.

How to Fix Individual MacBook Keys
Not Working

Step 1 — Use macOS Keyboard Viewer to confirm
exactly which keys are failing to generate signals.

Apple Menu → System Settings → Keyboard →
Keyboard Shortcuts → Input Sources →
Enable "Show Input menu in menu bar" → Done →
Click flag/language icon in menu bar →
Select "Show Keyboard Viewer" →
A visual keyboard appears on screen →
Press each affected key →
Watch: does the key highlight in Keyboard Viewer? →
Yes = key generates signal, problem is application/software →
No = key generates no signal, problem is physical switch or debris

This test takes two minutes and definitively categorizes
the problem as physical or software before you apply any fix.
If a key highlights in Keyboard Viewer but does not produce
output in your text editor, the issue is application-level —
a text substitution rule, an autocorrect override,
or an application-specific keyboard shortcut capturing the input.
If a key does not highlight at all, skip application-level fixes
and go directly to physical cleaning and hardware assessment.

Step 2 — Apply compressed air at the Apple-specified
75-degree angle with the four-direction rotation sequence.

Power off MacBook completely →
Hold MacBook at 75-degree angle — nearly vertical,
keyboard facing toward you →
Attach thin straw extension to compressed air can →
Position straw tip at LEFT edge of affected key →
Spray: 3 bursts × 2 seconds each →
Rotate MacBook 90 degrees clockwise →
Spray at what is now the TOP edge of key →
3 bursts × 2 seconds →
Rotate MacBook 90 degrees clockwise again →
Spray at what is now the RIGHT edge →
3 bursts × 2 seconds →
Rotate MacBook 90 degrees clockwise again →
Spray at what is now the BOTTOM edge →
3 bursts × 2 seconds →
Power on → test key →
Repeat full sequence twice more if key still fails

The 75-degree angle is not arbitrary — Apple specified it in
their official cleaning documentation because gravity assists
debris removal at this angle. Spraying at 90 degrees (fully upright)
can push debris sideways into other keys. Spraying flat sends debris
deeper into the mechanism. The four-direction rotation ensures
compressed air reaches under all edges of the key dome.
Never use canned air that has been shaken or inverted —
the liquid propellant that sprays when the can is cold or
inverted causes more damage than the debris being removed.

Step 3 — Check Apple’s Keyboard Service Program
eligibility for 2015–2019 butterfly keyboard models.

Find MacBook serial number:
Apple Menu → About This Mac → Serial Number →
Click serial number to copy →
Visit: support.apple.com/keyboard-service-program-for-mac-notebooks →
Enter serial number in eligibility checker →
Confirm whether your model qualifies →
If eligible: schedule service appointment →
Repair is free regardless of warranty status

Apple’s Keyboard Service Program covers MacBook (2015–2019),
MacBook Air (2018–2019), and MacBook Pro (2016–2019) models
experiencing key repeat issues, unresponsive keys, or keys
that feel different than surrounding keys. The program replaces
the entire keyboard assembly at no cost even if your MacBook
is out of warranty and out of AppleCare.
If your model qualifies, this is a free hardware repair
that resolves individual key failures definitively.
Check this before attempting any paid repair.

Step 4 — Clean suspect key contacts
with 90%+ isopropyl alcohol for liquid residue.

Power off MacBook → disconnect all cables →
Obtain 90% or higher isopropyl alcohol (not rubbing alcohol below 70%) →
Apply small amount to lint-free cloth or cotton swab →
Squeeze or wring out thoroughly — swab should be barely damp →
Press swab gently under each edge of the affected key →
Use small circular motion at each edge →
Repeat on all four edges of the key →
Allow minimum 45 minutes drying time →
Do not power on while any moisture remains →
Power on → test key → repeat if partially improved

90%+ isopropyl alcohol dissolves mineral deposits and dried
beverage residue from key contacts without leaving conductive residue
as it evaporates. The concentration matters — 70% isopropyl
contains 30% water, which is too high and risks spreading
the damage. Do not use household cleaners, window cleaners,
acetone, or any spray cleaner — these chemically damage
the key cap coating and the membrane material beneath.

Step 5 — Remap failed keys to functional alternatives
using Karabiner-Elements as a working solution during repair wait.

Download Karabiner-Elements from: karabiner-elements.pqrs.org →
Install and launch →
Open Karabiner-Elements Preferences →
Click "Simple Modifications" tab →
Click "Add item" →
"From key": select your failed key (e.g., e) →
"To key": select a low-use key
(e.g., right_option, forward_delete) →
Repeat for each failed key →
Test new mapping in TextEdit

Karabiner-Elements is free, open-source, and trusted
in the macOS keyboard customization community.
It remaps at the macOS kernel input level — meaning
the remapping works system-wide in every application,
including login screen (after accessibility permissions
are granted). This does not fix the hardware problem
but allows full productivity while you arrange
keyboard service or wait for a Service Program appointment.

Step 6 — Inspect failed key cap visually
for retainer separation or physical damage.

Power off MacBook →
Use bright LED flashlight →
Angle light at 15–20 degrees to key surface →
Look at each affected key from the side →
Compare height to adjacent working keys →
Check for: key sitting higher than neighbors,
visible wobble when pressed from the side,
key cap that moves laterally but does not spring back →
If retainer damage is visible: do not attempt removal →
Book Apple service — retainer replacement
requires full keyboard assembly access

A damaged retainer is identifiable without removing the key cap.
Never attempt to remove a butterfly key cap with anything other
than the specific plastic spudger technique — they are extremely
fragile and break instantly when pried incorrectly.
Scissor mechanism key caps (2020+) are more forgiving
but still require the correct removal angle.
If you see visible retainer damage, the repair requires
a keyboard assembly replacement at Apple —
attempting DIY retainer replacement almost always
breaks additional components and makes the repair more expensive.

Scenario 3 — MacBook Keyboard
Typing Wrong or Unexpected Characters

A MacBook keyboard that types wrong characters — where pressing Q
produces A, or where the number row produces symbols instead of numbers,
or where every vowel key produces an accented character —
is almost never a hardware problem. It is a software configuration
state that changes keyboard output without changing keyboard hardware.
And in the majority of cases, it resolves in under two minutes
once you know where to look.

The distinction between “keyboard not working” and “keyboard typing
wrong characters” matters because the fix paths diverge completely.
Wrong characters almost always means the keyboard is physically
working — it is generating signals, macOS is receiving them,
and applications are responding — but the character map translating
physical key position to output character has changed from what
is printed on your key caps.

Three macOS systems can cause this independently:
Input Source (keyboard language layout),
Modifier Keys remapping, and Text Substitutions.
A fourth possible cause — rare but documented — is a rogue
third-party input manager or malware intercepting keyboard input
and substituting different characters. This guide covers all four
in order from most to least common.

Why MacBook Keyboard Types Wrong Characters

Input Source switched to a different language layout
remaps every physical key position to that language’s character set.
The US English QWERTY layout, UK English layout, French AZERTY,
German QWERTZ, Spanish, Portuguese, and dozens of other language
layouts all assign different characters to the same physical key positions.
When macOS switches Input Sources — which happens instantly
from a keyboard shortcut most users trigger accidentally —
every key immediately outputs the character from the new layout
rather than the one printed on the physical key cap.
Pressing Q on a French AZERTY layout produces A.
Pressing M on a French layout produces comma.
The entire layout has shifted. This is not damage, not a glitch,
not a hardware problem. It is a single-click fix in the menu bar —
but only if you recognize it as a layout switch rather than
interpreting it as malfunction.

Modifier Keys remapping in System Settings assigns
unexpected functions to Caps Lock, Control, Option, or Command,
changing output for all shortcuts and modifier-dependent characters.
macOS allows any modifier key to be reassigned to any other modifier
key or to No Action. When Caps Lock is remapped to Control,
pressing Caps Lock triggers Control key behavior rather than
toggling capitalization — causing unexpected character output
in any context where the user expects Caps Lock behavior.
When Option is remapped to Command or vice versa,
every keyboard shortcut involving those keys produces
unexpected actions. This remapping is frequently applied
by previous owners of a second-hand MacBook,
by system administrators who configure multiple devices,
or by users following a productivity tutorial —
and then forgotten, leaving the next user confused
by unexpected modifier behavior.

Text Substitutions and autocorrect rules in macOS
automatically replace specific key sequences with different text,
making certain characters appear to type wrong output.
macOS System Settings includes a Text Replacements panel
where any text string can be set to automatically replace
another string when typed. If a Text Replacement rule uses
a single character as its trigger — for example, replacing
“q” with a copyright symbol — every time that character
is typed, macOS instantly substitutes the replacement.
This creates the appearance of the key typing the wrong character
because the substitution happens faster than the user can see
the original character appear. Autocorrect can produce
similar effects by aggressively replacing character sequences
with autocorrected versions that do not match the typed input.

A third-party keyboard input manager installed by
a productivity app, accessibility tool, or malicious application
intercepts keyboard signals and outputs different characters
than the keys pressed.
Some third-party applications install components at the macOS
system extension or input method editor level — giving them
access to keyboard input before any application receives it.
Input Method Editors (IMEs) for East Asian language input,
custom keyboard layout tools, typing assistants,
and text expander applications all use this level of access
legitimately. But if one of these components malfunctions,
becomes corrupted, or is installed by a malicious application,
it can systematically alter the characters output by keyboard input.
This type of failure is distinct from layout switching because
it persists even after correcting Input Sources and survives
restarts — the component reinstalls itself each launch.

How to Fix MacBook Keyboard Typing
Wrong Characters

Step 1 — Check the Input Source indicator in the menu bar
and switch back to your correct language layout.

Look at the right side of the menu bar →
Find a small flag icon or two-letter language abbreviation →
If it shows a flag that is not your country's: click it →
Select your correct language from the dropdown →
Open TextEdit immediately →
Type: the quick brown fox →
Confirm output matches what you typed →
If menu bar shows no flag:
Apple Menu → System Settings → Keyboard →
Input Sources → Edit →
Remove all Input Sources except your primary language →
Re-enable "Show Input menu in menu bar" checkbox →
Click Done

This is the correct first step for wrong-character output,
every time, without exception. Do it before anything else.
It takes 20 seconds. If it resolves the problem —
and it does in the majority of wrong-character cases —
you also need to prevent recurrence.
Go to System Settings → Keyboard → Keyboard Shortcuts →
Input Sources → and uncheck “Select the previous input source”
shortcut if you only use one language.
This prevents accidental Input Source switching in the future.

Step 2 — Reset all Modifier Keys to system defaults.

Apple Menu → System Settings → Keyboard →
Keyboard Shortcuts → Modifier Keys →
For each modifier key listed (Caps Lock, Control, Option, Command):
Check dropdown value →
Caps Lock should show: "⇪ Caps Lock" →
Control should show: "^ Control" →
Option should show: "⌥ Option" →
Command should show: "⌘ Command" →
If any shows a different value: click dropdown →
select the key's own name to restore default →
Click OK →
Test keyboard with modifier combinations

After resetting, specifically test:
Caps Lock for capitalization behavior,
Command + C and Command + V for copy/paste,
Option + key combinations for special characters,
and Shift for uppercase. These are the modifier interactions
most affected by remapping. If any of these behaved
unexpectedly before and now work correctly after the reset,
Modifier Keys remapping was the cause.

Step 3 — Clear all Text Replacements and disable
autocorrect features.

Apple Menu → System Settings → Keyboard →
Text Replacements →
Select all rules listed (Command + A) →
Click minus button (—) to delete all →
Confirm deletion →
Also disable:
"Correct spelling automatically" → Toggle OFF →
"Capitalize words automatically" → Toggle OFF →
"Add period with double-space" → Toggle OFF →
"Use smart quotes and dashes" → Toggle OFF →
Open TextEdit → test all keys that were producing wrong output

Deleting all Text Replacements rules and disabling autocorrect
removes every automatic substitution that macOS applies to
keyboard input. If wrong-character output stops after this step,
a Text Replacement rule was the cause — you can re-add rules
selectively afterward, avoiding any single-character triggers
that would recreate the problem.

Step 4 — Remove third-party Input Method Editors
and keyboard utilities from System Extensions.

Apple Menu → System Settings → Privacy & Security →
Extensions → Keyboard →
Review listed extensions →
Disable any unfamiliar or third-party keyboard extensions →
Apple Menu → System Settings → General →
Login Items & Extensions →
"Open at Login" section →
Remove: typing assistants, text expanders,
IME applications, keyboard customization apps →
Restart MacBook →
Test keyboard in TextEdit

After restarting without third-party keyboard extensions,
test the full keyboard before reopening any productivity
or utility applications. If wrong-character output is resolved,
re-enable extensions one at a time with a restart between
each one to identify which specific extension caused the conflict.
Contact that application’s developer for a macOS compatibility update.

Step 5 — Run a malware scan to rule out unauthorized
keyboard input interception.

Download Malwarebytes for Mac from: malwarebytes.com/mac →
Install and open →
Click "Get Started" → select free scanner option →
Click "Scan Now" →
Allow full scan to complete (5–15 minutes) →
Review detected items →
Quarantine all detected threats →
Click "Confirm" →
Restart MacBook →
Test keyboard in TextEdit

Malwarebytes for Mac is free for on-demand scanning
and does not require a paid subscription for this use case.
It detects known keyboard interceptors, adware,
and malicious input method editors that may be
systematically altering keyboard output.
A clean scan result rules out malicious software
as the cause and confirms the problem is a
legitimate macOS configuration issue requiring
a clean reinstall or further system-level investigation.

Step 6 — Create a new user account to test
keyboard in a clean user environment.

Apple Menu → System Settings → Users & Groups →
Add Account → enter admin password →
Account Type: Standard →
Create with any test name and password →
Apple Menu → Log Out →
Log into new test account →
Open TextEdit →
Test all keys that were producing wrong characters →
Compare output between test account and your regular account

If wrong-character output is absent in the new user account
but present in your regular account, the cause is a
user-specific configuration: a user-installed input manager,
a corrupted user preference file, or a user-level Text Replacement
rule that was not visible in the system settings panel.
Delete user-specific keyboard preference files in your regular account
(as described in Step 5 of General Fixes) rather than migrating
to a new account if you prefer to keep your existing profile.

Scenario 4 — MacBook Keyboard Died
After macOS Update

A MacBook keyboard that worked perfectly before a macOS update
and fails immediately after one has a clearly identified cause —
and in most cases a fast resolution. The update process itself
is not the final problem. What the update does to NVRAM,
to third-party kernel extensions, and to keyboard preference
files is where the problem originates.

Post-update keyboard failures divide into three categories.
The first is NVRAM corruption — the update process wrote an
incompatible value to a keyboard configuration parameter in NVRAM,
which persists through restarts and causes keyboard initialization
to fail or behave incorrectly on every boot. NVRAM reset resolves this.
The second is third-party extension incompatibility — a keyboard utility,
input manager, or accessibility tool that loaded correctly on the previous
macOS version loads an incompatible kernel extension on the new version,
crashing or blocking the input pipeline. Safe Mode and extension removal
resolve this. The third is an incomplete update installation that left
keyboard driver files in an inconsistent state between old and new versions.
Only a full macOS reinstall resolves this.

The sequence below addresses all three categories in order
from fastest fix to deepest intervention,
ensuring you apply the least disruptive solution that resolves your situation.

MacBook keyboard not working fixing

Why macOS Updates Kill MacBook Keyboard Function

NVRAM stores keyboard parameters in a format that the new macOS
version expects to be different, causing keyboard initialization
to fail or apply settings incorrectly on every boot after the update.
NVRAM persists through standard restarts — that is its purpose.
It remembers hardware configuration between boots so macOS
does not need to rediscover everything from scratch on each startup.
But when a macOS update changes the expected format or valid range
of a keyboard NVRAM parameter, the value stored from the previous
OS version may cause the new macOS to apply it incorrectly —
resulting in keyboard failures that appear immediately after the update
and persist indefinitely through standard restarts.
An NVRAM reset clears all stored parameters and forces macOS
to initialize keyboard configuration from defaults,
resolving this category of post-update failure completely.

Third-party kernel extensions for keyboard utilities
become incompatible with the updated macOS kernel version
and crash or block keyboard input pipeline access.
macOS updates change kernel interfaces, security requirements
for System Extensions, and the allowed capabilities of kernel-level
software. Third-party applications that install keyboard-level components —
custom input method editors, keyboard remapping tools, accessibility software,
and typing assistants — may have components that are compiled against
the previous kernel version and fail to load or crash when the new kernel
is present. When these components crash at a level inside the keyboard
input pipeline, they can block all keyboard input from reaching macOS —
creating a total keyboard failure that appears immediately after the
update and resolves immediately when the incompatible extension is disabled.

macOS update changes the schema of keyboard accessibility
preference files, causing values from the previous version
to be applied in unexpected ways under the new OS.
Major macOS version updates (for example Ventura to Sonoma,
Sonoma to Sequoia) sometimes change how accessibility keyboard
settings are stored and interpreted in preference files.
When the new macOS reads a preference file written by the previous version,
it may interpret a stored value differently — enabling an accessibility
feature like Slow Keys or Sticky Keys that was disabled under the old version,
or applying a modifier key remapping in a way the old version
did not implement. The result is keyboard behavior that changed
at exactly the moment of the update, caused by macOS now reading
a preference value differently rather than by any change in the
preference file itself.

An interrupted or failed update installation leaves keyboard
driver files in an inconsistent mixed state between old and new versions.
macOS updates that fail partway through — from power loss, storage errors,
network disconnection during download, or forced shutdown during installation —
can leave system files in a mixed state. Some keyboard-related system files
may have been updated to the new version while others remain at the old version.
These mismatched files may be mutually incompatible — the new driver
expecting an interface that the old support file does not provide,
or vice versa. This failure type is the most resistant to targeted fixes:
it survives NVRAM reset, SMC reset, and preference file deletion,
resolving only when a complete macOS reinstall replaces all system files
with a consistent, complete set from the new version.

How to Fix MacBook Keyboard That Died
After macOS Update

Step 1 — Perform NVRAM reset as the immediate
first response to any post-update keyboard failure.

Intel MacBook — NVRAM Reset:
Completely shut down MacBook →
Press Power Button →
Immediately hold: Option + Command + P + R simultaneously →
All four keys held at the same time without release →
Hold for 20 full seconds →
Release all keys →
Allow MacBook to boot completely without interruption →
If prompted: reconfigure display resolution, startup disk, time zone →
Open TextEdit → test keyboard immediately

Apple Silicon MacBook:
Apple Menu → Shut Down →
Wait 30 seconds →
Press Power Button →
Allow complete boot →
Apple Silicon reinitializes all NVRAM parameters automatically on boot

Perform this step before anything else for post-update keyboard failure.
It takes under two minutes, requires no tools, erases no data,
and resolves NVRAM-related post-update keyboard failures completely.
After booting, test keyboard in TextEdit before opening
any other application — particularly before launching any
third-party keyboard utility or productivity tool that may
reinstall a problematic extension.

Step 2 — Reset SMC after NVRAM reset if keyboard still fails.

Check chip: Apple Menu → About This Mac → Overview

Apple Silicon (M1/M2/M3/M4):
Apple Menu → Shut Down → wait 30 seconds → Power Button

T2 Intel (MacBook Pro/Air 2018–2020):
Shut Down →
Hold Left Control + Left Option + Right Shift (7 seconds) →
Add Power Button → hold all four (7 more seconds) →
Release all → wait 5 seconds → Power Button

Non-T2 Intel (2017 and earlier):
Shut Down →
Hold Left Shift + Left Control + Left Option + Power →
All simultaneously for 10 seconds →
Release → Power Button

If NVRAM reset did not restore keyboard function,
SMC reset addresses the hardware communication firmware layer
that NVRAM reset does not reach. Apply them sequentially —
NVRAM first, test, then SMC if still needed.
Testing between each reset helps identify exactly which layer
the post-update failure originated in — valuable information
if the problem recurs after a future update.

Step 3 — Boot into Safe Mode to identify
third-party extension incompatibility.

Apple Silicon MacBook:
Shut Down →
Press and hold Power Button →
Hold until startup options screen appears →
Select your startup disk →
Hold Shift key →
Click "Continue in Safe Mode" →
Log in normally →
Test keyboard in TextEdit

Intel MacBook:
Restart →
Hold Shift key immediately after pressing Power Button →
Hold until login screen appears with “Safe Boot” text →
Log in →
Test keyboard in TextEdit

After testing in Safe Mode:
If keyboard works in Safe Mode = third-party extension conflict
Return to normal mode and proceed to extension removal

Safe Mode disables all third-party kernel extensions
and system extensions, loads only essential drivers,
and clears several system caches.
If keyboard function restores completely in Safe Mode
but fails in normal mode, a third-party keyboard extension
that became incompatible with the updated macOS
is definitively the cause. The next step is identifying
and removing that specific extension.

Step 4 — Remove incompatible third-party keyboard
extensions identified through Safe Mode testing.

Boot into normal mode →
Apple Menu → System Settings → General →
Login Items & Extensions →
"Open at Login": disable and remove any keyboard tools →
Also check: System Settings → Privacy & Security →
Extensions → Keyboard →
Disable all listed third-party keyboard extensions →
Restart MacBook →
Test keyboard →
If keyboard now works: re-enable extensions one at a time
with a restart between each to isolate the conflicting one →
Once identified: check developer website for macOS compatibility update →
Or replace with compatible alternative tool

Work through extensions one at a time rather than removing all
simultaneously — this identifies the specific conflict
rather than requiring you to guess which tool to reinstall later.
For each re-enabled extension, test for 10 minutes before
enabling the next one. The conflicting extension typically
causes keyboard failure immediately or within a few minutes
of being active on the updated macOS.

Step 5 — Delete keyboard preference files that may contain
schema-incompatible values from the previous macOS version.

Open Finder → Command + Shift + G →
Type: ~/Library/Preferences/ → Return →
Move to Trash:
com.apple.HIToolbox.plist
com.apple.keyboard.plist
com.apple.symbolichotkeys.plist
com.apple.universalaccess.plist →
Command + Shift + G again →
Type: /Library/Preferences/ → Return →
Move to Trash if present:
com.apple.keyboard.plist →
Empty Trash →
Restart MacBook →
Test keyboard in TextEdit before opening any other app

Include com.apple.universalaccess.plist specifically
for post-update failures — this file contains accessibility
keyboard settings that are most likely to be applied
differently by a new macOS version than the previous one.
Deleting it forces macOS to write a fresh,
current-version-compatible version with correct default values.
After restart, check Accessibility settings to confirm
Slow Keys and Sticky Keys are still disabled.

Step 6 — Reinstall macOS via Recovery to fix
incomplete or failed update installations.

Boot Recovery:
Apple Silicon: Hold Power Button → Options → Continue
Intel: Restart → Hold Command + R

In Recovery:
Select “Reinstall macOS [version name]” →
Continue → agree to license →
Select your startup disk →
Click Install →
Allow 30–60 minutes →
MacBook restarts automatically several times →
DO NOT power off during installation →
SELECT REINSTALL — not “Erase Mac” →
All files, apps, and data are preserved

A reinstall from Recovery downloads a complete,
verified macOS image and replaces every system file —
resolving any inconsistency between old and new system files
left by a failed update. After reinstallation,
test keyboard before installing any third-party applications.
Confirm the base system is clean before adding external tools
that may reintroduce extension conflicts.

Final Checklist — MacBook Keyboard
Not Working — Every Fix in Sequence

  • Force restart first — hold Power Button 10 seconds,
    wait 30 seconds, power on:
    Hold Power Button → 10 seconds → 30 second wait → Power on
  • Check Input Source in menu bar — flag icon must match
    your language:
    Menu bar → flag icon → select correct language
  • Remove extra Input Sources:
    System Settings → Keyboard → Input Sources → Edit →
    remove all extras
  • Disable Slow Keys:
    System Settings → Accessibility → Keyboard →
    Slow Keys → OFF
  • Disable Sticky Keys and its activation shortcut:
    System Settings → Accessibility → Keyboard →
    Sticky Keys → OFF → Options → uncheck Shift shortcut
  • Disable Mouse Keys:
    System Settings → Accessibility → Pointer Control →
    Mouse Keys → OFF
  • Reset all Modifier Keys to defaults:
    System Settings → Keyboard → Keyboard Shortcuts →
    Modifier Keys → reset each key
  • Connect external USB keyboard to isolate hardware
    vs software
  • Run Apple Diagnostics:
    Hold D at startup (Intel) / Power Button hold (Apple Silicon)
  • Use Keyboard Viewer to identify which keys
    generate signals:
    Menu bar → Input menu → Show Keyboard Viewer
  • Clean debris-affected keys with compressed air
    at 75-degree angle — four-direction rotation sequence
  • Check Apple Keyboard Service Program eligibility
    for 2015–2019 butterfly keyboard models
  • Clean liquid residue with 90%+ isopropyl alcohol
    — barely damp swab, 45-minute dry time minimum
  • Reset NVRAM (Intel):
    Power on → hold Option + Command + P + R →
    20 seconds
  • Reset SMC using the correct procedure
    for your MacBook chip and model year
  • Delete keyboard preference files:
    ~/Library/Preferences/ → delete HIToolbox, keyboard,
    symbolichotkeys, universalaccess .plist files
  • Boot Safe Mode to disable third-party extensions:
    Hold Shift at startup (Intel) / Power → hold Shift (Apple Silicon)
  • Remove third-party keyboard tools from Login Items:
    System Settings → General → Login Items & Extensions
  • Clear all Text Replacements and disable autocorrect:
    System Settings → Keyboard → Text Replacements →
    delete all
  • Run Malwarebytes for Mac scan for unauthorized
    input interceptors
  • Create new user account to isolate user-specific cause:
    System Settings → Users & Groups → Add Account
  • Reinstall macOS via Recovery as final software fix —
    Reinstall option only, not Erase Mac

When the Problem Is Hardware —
Go to Apple

Every fix in this guide addresses software-level, firmware-level,
and accessible physical interventions — compressed air cleaning,
isopropyl alcohol for liquid residue, preference file management,
system resets. When these are exhausted and the keyboard
still does not function correctly, the problem is a hardware
fault that requires professional access to the MacBook internals.

Stop software troubleshooting and book Apple service
immediately if any of the following are true:

  • The MacBook had liquid contact — any amount — in the past 72 hours.
    Liquid damage spreads through capillary action and worsens over time
    if not professionally cleaned.
  • Multiple adjacent keys failed simultaneously without any
    physical event — suggesting membrane damage across a contiguous area
    rather than individual key debris.
  • Keys register input without being pressed —
    phantom keypresses appear in documents spontaneously.
    This is a membrane short circuit, not a software issue.
  • Apple Diagnostics returned keyboard-specific error codes
    (NDK or NDD series errors).
  • The keyboard fails in macOS Recovery mode —
    completely independent of your installed macOS —
    with no possible software explanation.
  • The MacBook was dropped, impacted, or physically damaged
    before the keyboard failure appeared.
  • Keyboard failures are intermittent and correlated with
    flexing the MacBook chassis — suggesting a partially
    disconnected ribbon cable.
  • Your model is a 2015–2019 butterfly keyboard MacBook —
    check the free Keyboard Service Program before paying for any repair.
  • Individual key caps are visually broken, missing,
    or sitting at a different height than adjacent keys.

Phantom keypresses — characters appearing in documents without
any key being pressed — are the most important hardware signal
on this list. Do not continue sensitive work on a MacBook
with phantom keypresses. The same membrane short circuit
causing phantom input can trigger accidental keypresses
in password fields, financial applications,
and any context where unintended input causes damage.

Book a Genius Bar appointment at
Apple Support
from the Apple Support app or at support.apple.com.
In-store hardware diagnostics are free.
2015–2019 butterfly keyboard models qualify for free keyboard
replacement under the Keyboard Service Program regardless of
warranty status — check eligibility before authorizing any paid repair.
Apple diagnostics are free. Go before spending money on guesses.

MacBook Keyboard Not Working —
Quick Reference Table

Situation You Are Experiencing Most Likely Root Cause First Fix to Apply Right Now Expected Result After Fix
Keyboard completely silent — zero response on any key SMC firmware freeze or crashed HID input daemon Force restart (hold Power 10 sec), then correct SMC reset Full keyboard function restores in majority of
total-failure cases after SMC reset
One or two specific keys dead, all others working fine Debris under butterfly switch or dried liquid
residue on key contact		 Compressed air at 75 degrees, four-direction rotation,
three bursts per edge		 Debris-caused key failures resolve in most cases
immediately after correct cleaning technique
Keys produce wrong characters — layout seems shifted Input Source switched to different language layout accidentally Click flag icon in menu bar, switch back to correct language Correct character output restores the instant
the correct Input Source is selected
Keyboard failed immediately after macOS update NVRAM holds incompatible keyboard config from previous OS NVRAM reset (Intel: Option+Command+P+R for 20 sec) Most post-update keyboard failures resolve
fully after NVRAM and SMC reset sequence
Keyboard works in Safe Mode, fails in normal mode Third-party keyboard extension incompatible with
updated macOS kernel		 Remove keyboard tools from Login Items and
System Extensions, restart		 Keyboard function restores after conflicting
extension is removed or disabled
Modifier keys (Shift, Command, Option) behave unexpectedly Modifier Keys remapping applied in System Settings System Settings → Keyboard → Keyboard Shortcuts →
Modifier Keys → reset all to defaults		 Correct modifier behavior restores immediately
after resetting all modifier key assignments
Keyboard works in new user account, fails in regular account Corrupted user-specific keyboard preference file
or user-installed input manager		 Delete HIToolbox.plist and keyboard.plist
from ~/Library/Preferences/		 Fresh preference files regenerated with correct defaults,
behavior normalizes after restart
Keys register phantom input —
characters appear without pressing keys		 Membrane short circuit from liquid damage Stop use immediately — book Apple Genius Bar
for hardware diagnostic		 Hardware repair or keyboard assembly replacement
required — not resolvable with software
All software and firmware fixes applied —
still not working		 Physical hardware fault — ribbon cable,
membrane failure, or logic board		 Apple Genius Bar — free hardware diagnostic,
Keyboard Service Program eligibility check		 Hardware fault identified, free repair possible
under Keyboard Service Program for 2015–2019 models

Conclusion — How to Fix MacBook
Keyboard Not Working

MacBook keyboard not working is a solvable problem
in the majority of cases — but only when you correctly identify
which of the three failure layers — hardware, firmware, or software —
contains the actual fault. Applying firmware fixes to a software problem
wastes time. Applying software fixes to a hardware problem wastes more time
and delays the repair that will actually work.

The diagnostic sequence in this guide is designed to move
from fastest and least invasive to slowest and deepest.
Force restart. Check Input Source. Check Accessibility settings.
Test with external keyboard. Run Apple Diagnostics.
Clean with compressed air. Reset NVRAM and SMC.
Delete preference files. Test in Safe Mode.
Reinstall macOS. At each step, you either find the resolution
or narrow the remaining possibilities.

For complete keyboard silence, SMC reset resolves the majority
of cases where the failure was sudden and without physical cause.
For individual key failures, compressed air at the correct angle
resolves debris-caused failures on butterfly keyboards,
and the Apple Keyboard Service Program covers free repair
on qualifying 2015–2019 models. For wrong characters,
Input Source correction resolves most cases in under one minute.
For post-update failures, NVRAM reset and Safe Mode testing
cover the two most common causes without any data loss.

If every fix in this guide has been applied and the keyboard
still does not function correctly on a MacBook that passes
Apple Diagnostics with no errors, the remaining cause is
physical hardware access — ribbon cable inspection or
keyboard assembly replacement — that requires professional service.
Apple diagnostics are free. Go before spending money on guesses.

FAQ — MacBook Keyboard Not Working

Can I use my MacBook normally with an external keyboard
while waiting for repair?

Yes — macOS supports external keyboards connected via USB-C
(with an adapter for USB-A keyboards) or Bluetooth with
zero configuration required. The Apple Magic Keyboard pairs
via Bluetooth and supports all Mac keyboard shortcuts including
Function keys, Mission Control, and Spotlight.
Third-party mechanical keyboards work via USB without
additional drivers in most cases. For MacBook models with Touch ID,
you can authenticate using the Touch ID on an Apple Magic Keyboard
with Touch ID (compatible with M1 and later Macs via Bluetooth).
An external keyboard is a full working solution for
hardware keyboard failures while arranging service.

Does NVRAM reset delete my files, apps, or user data?

No — NVRAM reset does not affect storage contents in any way.
It resets only hardware configuration parameters stored in
non-volatile memory: display resolution, startup disk selection,
time zone, speaker volume, and keyboard settings.
Your documents, photos, applications, user accounts,
and all macOS settings stored in your user library are completely untouched.
After an NVRAM reset, macOS may ask you to confirm display
resolution and time zone on first boot —
these take 30 seconds to reconfigure in System Settings.

How do I know if my MacBook qualifies for the free
Apple Keyboard Service Program?

The Apple Keyboard Service Program covers MacBook (2015–2019),
MacBook Air (2018–2019), and MacBook Pro (2016–2019) models
with butterfly keyboard mechanisms. Qualifying symptoms include
keys that repeat characters unexpectedly, keys that fail to register
keypresses, and keys that feel physically different than surrounding keys.
To check your specific device: find your serial number at
Apple Menu → About This Mac, then visit
support.apple.com/keyboard-service-program-for-mac-notebooks
and enter your serial number in the eligibility tool.
The repair is free regardless of warranty status or AppleCare coverage.

My MacBook keyboard randomly types double letters —
is this the butterfly problem?

Double letter output — typing one key and getting two of the same character —
is one of the primary documented butterfly keyboard failures
covered by Apple’s Keyboard Service Program. It occurs on 2016–2019
MacBook models when debris causes a key to bounce or when
the key repeat function triggers at an incorrect threshold
due to partial debris obstruction. Before booking service,
try the compressed air cleaning technique at 75 degrees —
occasionally debris removal resolves double-letter output temporarily.
If it recurs within a week, the issue is mechanical degradation
rather than debris and keyboard replacement under the
Service Program is the permanent solution.

Why does my MacBook keyboard work at the login screen
but fail after I log in?

This login-vs-after-login failure pattern almost always indicates
a third-party keyboard extension or login item that loads
after user session initialization and conflicts with the
keyboard input pipeline. The keyboard works at the login screen
because no user-specific login items or third-party extensions
are loaded yet. After login, a conflicting component loads and
breaks keyboard input routing. Boot into Safe Mode
(hold Shift at startup) — Safe Mode prevents all third-party
login items and extensions from loading.
If the keyboard works in Safe Mode after login,
remove keyboard-related third-party utilities from
Login Items in System Settings and isolate the conflict
by re-enabling them one at a time.

Is it safe to remove a MacBook key cap
to clean underneath it?

On 2020 and later MacBook models with the Magic Keyboard
scissor mechanism, key cap removal is possible but requires
a specific technique using a thin plastic spudger inserted
under one corner at 45 degrees — never straight up.
The scissor retainer releases in a specific direction.
On 2016–2019 butterfly mechanism MacBooks, key cap removal
is strongly discouraged. The butterfly retainer is extremely
fragile and breaks with minimal force applied incorrectly.
Apple technicians use compressed air rather than key cap removal
as the first cleaning intervention for butterfly keyboards
for exactly this reason. If debris persists after multiple
compressed air cleaning cycles on a butterfly keyboard,
book Apple service rather than attempting key cap removal.

Can a macOS update permanently damage the MacBook keyboard?

A macOS update cannot permanently damage keyboard hardware —
software does not cause physical damage to key switches,
membranes, or ribbon cables. What an update can do is corrupt NVRAM
parameters, introduce incompatible kernel extensions,
or leave preference files in a state that causes keyboard malfunction
until cleared. These are all fully recoverable: NVRAM reset,
extension removal, and macOS reinstall resolve all software and
firmware causes of post-update keyboard failure.
If keyboard failure after an update does not resolve with
these steps, the update coincided with but did not cause
a pre-existing hardware issue that was on the verge of manifesting independently.

Leave a Comment