MacBook Keyboard Not Working? Complete Fix Guide 2026

MacBook keyboard not working is one of the most disruptive
problems a MacBook owner can face — because unlike a desktop, you cannot simply
plug in a replacement and keep working. Whether your keyboard has gone completely
silent, specific keys stopped responding, or every keystroke is producing the wrong
character, the underlying cause matters enormously. The wrong fix wastes hours.
The right fix takes minutes.

The MacBook keyboard has gone through three distinct hardware generations since 2015 —
the butterfly mechanism (2016–2019), the Magic Keyboard scissor switch (2020–present),
and the Touch Bar era models — each with its own failure patterns and its own set
of solutions. Software issues layer on top of hardware issues. macOS settings
can silently change keyboard behavior. A recent update can break driver compatibility.
And physical debris can cause mechanical failures that look exactly like software
problems until you look closely.

This guide covers four real scenarios where MacBook keyboard not working is most
commonly reported: when the keyboard stops working completely with no response
at all, when specific individual keys stop registering or feel stuck, when keys
type the wrong characters or trigger unexpected actions, and when the keyboard
fails after a macOS update. Each scenario has a different cause and a precisely
targeted fix.

Quick answers before the full breakdown:

Keyboard not working at all: SMC reset or frozen macOS process —
force restart first, then SMC reset if restart does not resolve it.

Specific keys stuck or not responding: Physical debris under
butterfly or scissor mechanism, or a stuck key cap — compressed air cleaning
is the first intervention before any software step.

Wrong characters typing: Input source switched to wrong language
layout or Slow Keys/Sticky Keys accessibility setting silently enabled —
check Input Sources and Keyboard Accessibility settings immediately.

Stopped working after macOS update: Corrupted keyboard driver
cache or NVRAM holding stale keyboard configuration — NVRAM reset and SMC reset
resolve this in most cases without data loss.

MacBook Keyboard Not Working — Full Table of Contents

General Causes of MacBook Keyboard Not Working
General Fixes for MacBook Keyboard Not Working
Scenario 1 — MacBook Keyboard Not Working At All
Scenario 2 — Specific MacBook Keys Not Working or Stuck
Scenario 3 — MacBook Keyboard Typing Wrong Characters
Scenario 4 — MacBook Keyboard Not Working After macOS Update
Final Checklist — All Fixes in One Place
When to Go to Apple Directly
Quick Reference Table
FAQ — MacBook Keyboard Not Working

MacBook Keyboard Not Working — General Causes and Fixes

The MacBook keyboard sits at the intersection of hardware, firmware, and software —
which means a keyboard failure can originate from any of those three layers.
A crumb under a butterfly key switch causes a hardware failure. A corrupted
NVRAM entry causes a firmware failure. A wrong Input Source setting causes
a software failure. All three look similar from the outside — keys not working —
but require completely different interventions.

Understanding which MacBook generation you have matters before applying any fix.
MacBook Pro and MacBook Air models from 2016 to 2019 used Apple’s butterfly key
mechanism — an ultra-thin design notorious for sensitivity to dust and debris.
A single small particle under a butterfly key can cause it to stop registering
completely. MacBook models from 2020 onward use the Magic Keyboard scissor-switch
mechanism, which is more debris-tolerant but still susceptible to liquid damage
and key cap failures. Check your MacBook model:
Apple Menu → About This Mac → Overview to identify your exact model
year before proceeding.

The SMC — System Management Controller — is a critical piece of firmware that
controls low-level hardware functions including the keyboard. When the SMC
enters a corrupted or frozen state, the keyboard can go completely unresponsive
despite the MacBook appearing to boot and function normally. SMC resets are
non-destructive and take under 60 seconds — they should be in every MacBook
keyboard troubleshooting sequence before any deeper intervention.

macOS settings can silently alter keyboard behavior in ways that are easy to
mistake for hardware failures. The Accessibility panel contains Slow Keys,
Sticky Keys, and Mouse Keys settings that dramatically change how the keyboard
responds to input. Input Sources in System Settings can switch the active keyboard
layout to a different language layout where every key maps to a different character.
These software-level changes are instant and invisible — checking them takes
two minutes and rules out a significant category of apparent keyboard failures.

Most Common Causes of MacBook Keyboard Not Working

Physical debris trapped under butterfly mechanism key switches causes
complete key failure on 2016–2019 MacBook models.
Apple’s butterfly keyboard mechanism — used across MacBook, MacBook Pro,
and MacBook Air from 2016 to 2019 — reduced key travel to 0.55mm in its
thinnest version. This design is extraordinarily sensitive to contamination.
A single grain of sand, a small food particle, or even accumulated skin
cell debris can prevent a butterfly key from completing its electrical contact
when pressed. The key may feel physically normal but produce no input signal,
or it may feel physically stuck in the depressed position. Apple acknowledged
this design issue and introduced a Keyboard Service Program covering affected
models — which remains relevant for older MacBook owners experiencing
this exact failure pattern today.

SMC corruption or freeze causes the keyboard to stop responding
completely while other MacBook functions appear normal.
The System Management Controller handles fundamental hardware communication
on MacBook, including the keyboard interface. When the SMC enters an
error state — caused by power interruptions, abrupt shutdowns, battery
events, or software conflicts — the keyboard can go completely unresponsive
while the MacBook continues to boot, display video, and respond to trackpad
input normally. This SMC-related keyboard failure is frequently misidentified
as a hardware keyboard defect, but it resolves completely with an SMC reset
in most cases — a 60-second process that does not erase any data.

Input Source switched to a different language keyboard layout
causes every key to type the wrong character.
macOS supports dozens of keyboard input sources — language-specific layouts
where each physical key maps to a different character than the label on
the keycap. A keyboard shortcut — specifically
Control + Space or Command + Space
depending on Input Source settings — can switch between layouts with a
single accidental keystroke. Users frequently trigger this switch accidentally
and interpret the resulting wrong-character output as a hardware failure.
The keys are working perfectly — they are simply mapped to a different
character layout than the one printed on the physical keys.

Liquid contact — even minimal amounts — causes intermittent or
permanent key failures depending on severity and response time.
Even a small amount of liquid reaching the MacBook keyboard can cause
significant damage. Water and other liquids are electrically conductive
when they contain dissolved minerals or other solutes. When liquid reaches
the keyboard membrane or the key switch contacts, it can cause short circuits
that force keys to register false inputs, prevent keys from registering
any input, or cause random characters to appear without any key being pressed.
The damage pattern from liquid contact often appears gradually — keys may
work normally initially and fail progressively over hours or days as
residual liquid evaporates and leaves conductive mineral deposits on
the electrical contacts.

General Fixes for MacBook Keyboard Not Working

Step 1 — Force restart the MacBook before any other troubleshooting step.

Press and hold Power Button for 10 seconds → Release when MacBook shuts down completely → Wait 30 seconds → Press Power Button once to restart → Test keyboard immediately after login

A force restart clears all active processes — including any frozen system
daemon or input manager process that may be preventing keyboard signals
from reaching macOS. This is the correct first step for any MacBook
keyboard failure, including complete non-response. It takes 45 seconds
and resolves a significant percentage of sudden keyboard failures that
have no obvious physical cause. Do this before attempting any deeper
fix — it is non-destructive and takes less time than any other
troubleshooting step.

Step 2 — Check and reset Input Sources to confirm correct keyboard layout is active.

Apple Menu → System Settings → Keyboard → Input Sources → Edit → Confirm only one Input Source is listed → If multiple are listed, remove all but your primary language → Click Done

If your keyboard is typing but producing wrong characters, Input Sources
is the first place to look. An extra language layout added accidentally
means macOS may be sending input through the wrong character map.
Remove any unintended Input Sources, leave only your primary language layout,
and test immediately. Also confirm the Input Source indicator in the menu bar
shows the correct flag or language code for your region.

Step 3 — Check Accessibility settings for Slow Keys, Sticky Keys, and Mouse Keys.

Apple Menu → System Settings → Accessibility → Keyboard → Check: Slow Keys → Toggle OFF if enabled → Check: Sticky Keys → Toggle OFF if enabled → Apple Menu → System Settings → Accessibility → Pointer Control → Check: Mouse Keys → Toggle OFF if enabled

Slow Keys adds a delay before a keypress registers — it can make the
keyboard feel unresponsive to normal typing speed. Sticky Keys changes
how modifier keys (Shift, Command, Option) work, causing unexpected
behavior. Mouse Keys redirects keyboard input to control the cursor,
making most keys appear non-functional for typing. Any of these can
be enabled accidentally through an Accessibility shortcut.
Checking and disabling them takes two minutes and resolves a common
category of apparent keyboard failures immediately.

Step 4 — Test with an external USB or Bluetooth keyboard to isolate the fault.

Connect Apple Magic Keyboard via USB-C cable or Bluetooth → Apple Menu → System Settings → Bluetooth → Pair Magic Keyboard → Test typing in TextEdit → Compare behavior between built-in and external keyboard

Connecting an external keyboard is the fastest way to determine whether
your problem is hardware (built-in keyboard physically failed) or software
(macOS keyboard input system is the fault). If the external keyboard works
perfectly while the built-in keyboard does not, the problem is hardware —
specifically the built-in keyboard mechanism or its ribbon cable connection.
If the external keyboard also fails or shows the same wrong-character behavior,
the problem is in macOS software or settings — and software fixes will resolve it.

Step 5 — Run Apple Diagnostics to check for hardware faults.

Shut down MacBook completely → For Apple Silicon Macs: Press and hold Power Button → Continue holding until startup options appear → Press Command + D to launch Apple Diagnostics → For Intel Macs: Press Power Button → Immediately press and hold D key → Follow on-screen instructions → Note any error codes displayed at end of test

Apple Diagnostics runs a hardware verification test on the MacBook’s
internal components. Keyboard-related hardware faults generate specific
error codes that distinguish between a keyboard controller failure,
a ribbon cable connection problem, and a key switch failure.
If Diagnostics returns a clean result with no errors, the keyboard
hardware is intact and the problem is software or firmware —
making SMC and NVRAM resets the appropriate next steps.
If Diagnostics returns keyboard-specific error codes, Apple hardware
service is required.

Step 6 — Reset NVRAM to clear stale keyboard configuration data.

For Intel MacBooks: Shut down → Press Power Button → Immediately press and hold Option + Command + P + R simultaneously → Hold for 20 seconds → Release when you hear the startup chime a second time (or after 20 seconds on models without chime) → Allow MacBook to boot normally

For Apple Silicon MacBooks:
NVRAM resets automatically when needed →
Perform SMC equivalent: Shut down →
Wait 30 seconds → Restart →
Hold Power Button at startup for startup options if needed

NVRAM stores keyboard-related settings including modifier key remapping,
keyboard type configuration, and input source preferences. A corrupted
or stale NVRAM entry can cause persistent keyboard misbehavior that
survives restarts but resolves after an NVRAM reset. The reset does not
erase any files, apps, or user data. It clears only hardware configuration
parameters — display resolution, startup disk selection, keyboard settings,
and time zone data — all of which macOS reconfigures automatically on
the next boot.

Step 7 — Reset the SMC to restore keyboard hardware communication.

For MacBooks with Apple Silicon (M1, M2, M3, M4): Shut down MacBook completely → Wait 30 seconds → Press Power Button to restart → (SMC equivalent — Apple Silicon manages SMC functions automatically)

For Intel MacBooks with T2 chip (2018 and later):
Shut down →
Press and hold Control + Option (left side) + Shift (right side)
for 7 seconds →
While still holding those keys, also press and hold Power Button →
Hold all four keys together for another 7 seconds →
Release all keys → Wait 5 seconds → Press Power Button to start

For Intel MacBooks without T2 chip (2017 and earlier):
Shut down →
Press and hold Shift + Control + Option + Power Button
simultaneously for 10 seconds →
Release all keys → Press Power Button to start

The SMC reset is the single most effective software-level fix for
complete MacBook keyboard non-response. It resets the System Management
Controller to its default firmware state, restoring correct keyboard
hardware communication. The procedure differs between Apple Silicon,
T2 Intel, and older Intel MacBooks — using the wrong procedure for
your model will not damage anything, but it also will not perform
the reset. Confirm your MacBook model before applying the correct
procedure: Apple Menu → About This Mac.

Scenario 1 — MacBook Keyboard Not Working At All

A MacBook keyboard that produces absolutely no response — no characters,
no cursor movement, no function key actions — is the most alarming presentation
of this problem and, paradoxically, often one of the most resolvable.
Complete keyboard silence usually points to one of three causes: an SMC issue,
a frozen input manager process in macOS, or a physical disconnection of
the keyboard ribbon cable — typically from a drop or from repair work
that was not reassembled correctly.

Before assuming hardware failure, run through the software and firmware
sequence carefully. An SMC freeze causes 100% keyboard non-response while
the rest of the MacBook functions normally — it is one of the most common
MacBook support issues and one of the easiest to fix. A frozen macOS
process in the input management layer causes the same symptom but resolves
with a force restart alone. Only when both force restart and SMC reset
fail to restore any keyboard response should physical hardware be suspected.

Note whether the keyboard failure is total — not a single key works —
or partial — some keys work and others do not. Total failure almost always
points to SMC, firmware, or the ribbon cable connection. Partial failure
almost always points to physical debris under specific keys, localized
liquid damage, or individual key switch failures. The distinction matters
because the fix sequences diverge at this point.

Why MacBook Keyboard Stops Working At All

SMC firmware enters a corrupted or frozen state that halts all
keyboard hardware communication.
The System Management Controller is the firmware layer that interfaces
between physical MacBook hardware — including the keyboard — and macOS.
When the SMC enters a bad state from a power event, abrupt shutdown,
or software conflict, it can stop passing keyboard signals to the operating
system entirely. The MacBook boots, displays the login screen, and responds
to trackpad input because those pathways are separate — but every keypress
on the built-in keyboard generates no signal. This is frequently misdiagnosed
as a hardware failure because the symptom is identical: complete keyboard
silence. An SMC reset resolves it in under 60 seconds without any data loss.

A frozen or crashed HID (Human Interface Device) input manager
process in macOS blocks all keyboard input from reaching applications.
macOS routes all keyboard input through a system process called the HIDeventSystemClient
daemon. If this process crashes or freezes — which can happen after a software
conflict, a failed app installation, or a macOS update that did not complete
cleanly — keyboard signals reach the operating system but do not get forwarded
to applications or system functions. The keyboard itself is physically working.
macOS receives the signals. But the routing layer is broken. A force restart
terminates and relaunches all system daemons including the HID input manager,
resolving the problem completely.

Physical disconnection of the keyboard ribbon cable from the logic board
following a drop, repair, or shipping damage.
The MacBook keyboard connects to the logic board through a thin ZIF (Zero Insertion
Force) ribbon cable. This cable can partially or fully disconnect from a significant
drop impact, from a repair where the bottom case was removed and reassembled
incorrectly, or in rare cases from shipping damage on new or refurbished units.
A partially disconnected ribbon cable causes intermittent keyboard failures —
works sometimes, fails others — while a fully disconnected cable causes complete
keyboard silence identical to an SMC fault. Physical inspection requires removing
the bottom case, which should be done by Apple or an authorized technician
to avoid damaging other components.

Liquid contact with the keyboard membrane or logic board causes
immediate or delayed complete keyboard failure.
Even a small liquid spill — a few drops of water, coffee, or juice — reaching
the keyboard membrane can short-circuit multiple key contacts simultaneously.
The initial effect may be erratic key behavior or specific key failures.
As the liquid evaporates over hours and leaves mineral deposits on the contacts,
progressively more keys fail until the keyboard goes completely silent.
This progressive failure pattern after liquid contact is a diagnostic signal:
if keyboard failures multiplied over several hours or days after any liquid
exposure, liquid damage is the most likely cause and professional cleaning
or component replacement is required.

How to Fix MacBook Keyboard Not Working At All

Step 1 — Force restart the MacBook to clear any frozen input manager process.

Press and hold Power Button for 10 full seconds → MacBook shuts down completely → Wait 30 seconds → Press Power Button once → Allow full boot → Open TextEdit: Command + Space → type "TextEdit" → Enter → Test all keyboard keys

Hold the Power Button for the full 10 seconds — not 5, not 7.
The full 10 seconds ensures the MacBook performs a hard shutdown
rather than just initiating a normal restart sequence. After the 30-second
wait, power on and allow the MacBook to complete a full boot before testing.
Open TextEdit specifically for testing because it is a native Apple application
that responds to keyboard input without any third-party software involvement.

Step 2 — Connect an external keyboard to test whether the problem is hardware or software.

Connect Apple Magic Keyboard via USB-C to USB-C cable → Open TextEdit → Type a test sentence using external keyboard → Simultaneously attempt to type using built-in keyboard → Compare results

If the external keyboard works perfectly and the built-in keyboard produces
nothing, the problem is the built-in keyboard hardware or its ribbon cable
connection. If the external keyboard also produces no input, the problem
is software or macOS settings — and software fixes will resolve it.
This test takes two minutes and defines whether you are dealing with
a hardware or software problem, which determines every subsequent step.

Step 3 — Reset the SMC using the correct procedure for your MacBook model.

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

Intel MacBook with T2 chip (MacBook Pro 2018+, MacBook Air 2018+):
Shut down → Hold Left Control + Left Option + Right Shift for 7 seconds →
While holding, add Power Button → Hold all four for 7 more seconds →
Release → Wait 5 seconds → Power on

Intel MacBook without T2 chip (MacBook Pro 2017 and earlier):
Shut down → Hold Shift + Control + Option + Power simultaneously →
Hold 10 seconds → Release → Power on

Apple Silicon MacBook (M1/M2/M3/M4 any model):
Shut down completely → Wait 30 seconds → Power on normally

The SMC reset is the most important step for complete keyboard non-response.
After performing the correct reset for your model, allow the MacBook to
complete a full boot — do not interrupt the startup process. The keyboard
should be tested immediately after login before opening any applications.
If the keyboard responds after the SMC reset, the problem was firmware-level
and is now resolved. If it still does not respond, the problem is physical.

Step 4 — Boot into macOS Recovery to test keyboard in a clean software environment.

For Apple Silicon Macs: Shut down → Press and hold Power Button → Hold until "Loading startup options" appears → Select Options → Continue

For Intel Macs:
Restart → Immediately hold Command + R →
Hold until Apple logo appears →
Release and wait for Recovery environment to load

Test: Try typing in the Recovery search field or Disk Utility

macOS Recovery runs a minimal version of macOS loaded directly from firmware.
If your keyboard works in Recovery but not in normal macOS, the problem is
a macOS software conflict — a third-party keyboard extension, input manager,
or corrupted system preference — not hardware. If the keyboard also fails
in Recovery, the problem is definitively hardware: either the ribbon cable
connection or the keyboard assembly itself requires physical repair.

Step 5 — Delete corrupted keyboard preference files to resolve software conflicts.

Open Finder → Press Command + Shift + G → Type: ~/Library/Preferences/ → Press Enter → Find and delete these files: com.apple.HIToolbox.plist com.apple.keyboard.plist com.apple.symbolichotkeys.plist → Empty Trash → Restart MacBook

These preference files store keyboard configuration data accumulated over time.
A corrupted entry in any of these files can cause persistent keyboard
misbehavior that survives restarts and SMC resets. Deleting them forces
macOS to regenerate clean versions on the next boot. You will lose any
custom keyboard shortcut configurations you have set, but all standard
keyboard behavior restores immediately from Apple’s defaults.

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

Apple Menu → System Settings → Users & Groups → Click Add Account (enter admin password if prompted) → Account Type: Standard → Enter name and password → Create → Log out of current account → Log into new test account → Open TextEdit → Test keyboard

If the keyboard works in the new user account but not in your regular account,
the problem is a corrupted user-specific preference, a third-party input
manager installed in your user Library, or a conflicting accessibility
setting stored in your user profile. Migration of your data to a fresh
user account, or targeted deletion of user-specific keyboard-related
preference files, resolves the problem without reinstalling macOS.

Step 7 — Reinstall macOS via Recovery as a final software intervention.

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

In Recovery:
Select Reinstall macOS → Continue →
Agree to license →
Select startup disk → Install →
Allow process to complete (30–60 minutes) →
Do NOT erase disk — choose Reinstall only

A macOS reinstall replaces all system files without erasing your personal
data, applications, or settings. It resolves any software-level keyboard
failure caused by corrupted system components that survived preference
file deletion and SMC/NVRAM resets. If keyboard function does not restore
after a clean macOS reinstall, the problem is definitively hardware —
physical repair or keyboard replacement is required and no further
software intervention will help.

Scenario 2 — Specific MacBook Keys Not Working or Stuck

When specific individual keys stop working — while the rest of the keyboard
functions normally — the cause is almost always physical rather than software.
One or two keys failing while twenty others work perfectly points directly
at a localized physical issue: debris under that specific key, a failed
individual key switch, liquid residue on specific contacts, or a key cap
that has separated from its mechanism beneath.

This scenario is most common on MacBook models from 2016 to 2019 with the
butterfly keyboard mechanism. The butterfly design’s extreme thinness and
sensitivity to debris means that a single small particle — invisible to
casual inspection — under the Space bar, the E key, or any high-frequency
key can stop it from completing its electrical contact. Apple’s Keyboard
Service Program was specifically created to address this pattern and
replaced keyboard assemblies on qualifying models free of charge.

For 2020 and later MacBook models with the Magic Keyboard scissor mechanism,
individual key failures are less common from debris but more common from
liquid damage, key cap separation, or genuine switch failure after extended
use. The scissor mechanism tolerates debris better than butterfly but is
not immune to it, and the key cap removal process is different between the
two mechanisms — attempting butterfly key cap removal techniques on scissor
keys, or vice versa, can break the key cap retainer.

Why Specific MacBook Keys Stop Working

Physical debris under the butterfly mechanism prevents the key
from completing its electrical contact when pressed.
The butterfly mechanism in 2016–2019 MacBooks has a key travel of 0.55mm —
thin enough that a small debris particle sitting beneath the key dome
creates a physical obstruction that prevents the key from traveling
far enough to complete the electrical contact below it. The key may
feel physically stiff or feel normal but produce no character output.
Common debris culprits include food crumbs, sand particles from a
beach or outdoor environment, skin cell buildup near frequently used
keys, and small debris from paper or packaging materials. The E key,
Space bar, and letters adjacent to the trackpad are the most frequently
affected on butterfly MacBook models.

Liquid residue on key switch contacts creates an intermittent
or permanent open circuit at that specific key location.
When liquid contacts a keyboard membrane at a specific key location,
the initial damage is often intermittent — the key works sometimes
and fails other times as residual liquid moves with temperature and
gravity. As the liquid evaporates, it leaves mineral deposits —
primarily calcium, magnesium, and sodium salts from tap water,
or sugar and acid residues from beverages — directly on the electrical
contacts. These mineral deposits are electrically resistive or insulating
depending on their composition, and they prevent the key contact from
closing cleanly. This is why liquid-damaged keys often get progressively
worse rather than failing suddenly: the deposit builds up over days.

Key cap physical separation from the scissor or butterfly
retainer below it prevents the key from actuating the switch.
MacBook key caps are held in place by a plastic retainer — a butterfly
or scissor mechanism — that sits between the key cap and the membrane
switch below. These retainers can break or separate from the key cap
following impact, aggressive key cleaning attempts, or material fatigue
from extended use. When the retainer breaks, the key cap sits loosely
on the keyboard surface and wobbles rather than pressing firmly —
it may feel present but fail to actuate the membrane switch reliably
or at all. The Space bar retainer is particularly prone to breakage
during cleaning attempts because it uses a larger, more complex
multi-piece stabilizer bar mechanism.

Genuine individual key switch membrane failure from extended
high-frequency use on high-utilization keys.
The most frequently pressed keys — Space, E, T, A, O, Return —
accumulate far more actuations than less common keys. MacBook key
switch membranes have a rated life measured in millions of actuations,
but high-frequency keys on heavily used MacBooks can approach or
exceed that rating over several years of intensive daily use.
When a membrane switch fails from wear, the key stops registering
input entirely but may still feel mechanically normal when pressed —
the mechanism moves correctly but the electrical contact no longer
closes. This failure pattern is distinct from debris (which can be
cleaned) and from key cap issues (which can be reseated) — it requires
keyboard assembly replacement.

How to Fix Specific MacBook Keys Not Working

Step 1 — Clean beneath affected keys using compressed air at the correct angle.

Turn MacBook off completely → Hold MacBook at 75-degree angle (nearly vertical, keyboard facing you) → Use can of compressed air with thin extension straw → Direct air stream along the LEFT edge of the affected key → Spray in short 2-second bursts × 3 → Rotate MacBook 90 degrees → Spray along the BOTTOM edge of the same key × 3 → Rotate MacBook to opposite 90 degrees → Spray along the TOP edge of key × 3 → Return to 75-degree angle → Spray along RIGHT edge × 3 → Power on → Test key

Apple’s official cleaning recommendation for butterfly keyboard debris
specifies this exact angle and rotation sequence. The 75-degree angle
uses gravity to help debris fall away from the key mechanism rather
than deeper into it. The rotation sequence ensures compressed air
reaches under all four edges of the key dome. Do not spray compressed
air with the MacBook flat — debris gets pushed further under the key.
Do not use liquid compressed air cans upside down — liquid propellant
spraying into the keyboard causes more damage than debris.

Step 2 — Use the macOS Keyboard Viewer to confirm which keys are registering.

Apple Menu → System Settings → Keyboard → Keyboard Shortcuts → Input Sources → Enable "Show Input menu in menu bar" → Click Input menu in menu bar (flag icon) → Select "Show Keyboard Viewer" → Press each suspect key → Watch Keyboard Viewer to see if key highlights when pressed

Keyboard Viewer displays a visual representation of your keyboard and
highlights each key as it registers input. This is the most reliable
way to determine whether a key is physically actuating (pressing the
switch and generating a signal) without producing visible output in
a text field. If a key highlights in Keyboard Viewer when pressed,
the hardware is working and the problem is application-level or
character mapping. If a key does not highlight when pressed,
the hardware is not generating a signal — physical cleaning or
hardware repair is needed.

Step 3 — Remap the failed key to an alternative key as a temporary workaround.

Apple Menu → System Settings → Keyboard → Keyboard Shortcuts → Click "Modifier Keys" (bottom of list) → Or use third-party remapping: Download Karabiner-Elements from karabiner-elements.pqrs.org → Install → Open → Simple Modifications → Add Item → Select failed key → Map to working alternative key

Karabiner-Elements is a free, open-source keyboard remapping tool for
macOS that allows you to reassign any physical key to any other
character or function. If your E key fails, you can temporarily remap
an infrequently used key — like Right Option or Forward Delete —
to produce E until the hardware is repaired. This does not fix the
underlying hardware problem but allows you to continue working
productively while arranging repair.

Step 4 — Check whether your MacBook qualifies for Apple’s
Keyboard Service Program.

Visit: apple.com/support/keyboard-service-program-for-mac-notebooks → Enter your MacBook serial number → Apple Menu → About This Mac → Serial Number → Confirm model eligibility → Book service if eligible

Apple’s Keyboard Service Program covers MacBook, MacBook Air, and MacBook Pro
models from 2015 to 2019 with butterfly keyboards that experience key
repeat, unresponsive keys, or keys that feel different than surrounding keys.
The program provides free keyboard replacement regardless of warranty status.
If your MacBook falls in this model range and specific keys are failing,
checking service program eligibility should be an early step — not a
last resort — because it may provide a free hardware repair that no
software fix can match.

Step 5 — Clean individual key contacts with 90%+ isopropyl alcohol
if liquid residue is suspected.

Power off MacBook completely → Disconnect all cables → Apply small amount of 90%+ isopropyl alcohol to cotton swab → Squeeze swab to remove excess liquid → Gently press swab under affected key edges in circular motion → Allow to dry completely — minimum 30 minutes → Do NOT power on while any moisture remains → Power on and test

Isopropyl alcohol at 90% concentration or higher evaporates rapidly
and leaves no conductive residue. Applied carefully with a nearly dry
swab, it can dissolve and remove mineral deposits and dried beverage
residue from key contacts without damaging the keyboard membrane.
Never use rubbing alcohol below 70% concentration — the water content
is too high and can cause further damage. Never use household cleaners,
acetone, or any spray cleaner — these damage the key cap coating
and the membrane beneath.

Step 6 — Test the affected keys in Safe Mode to rule out third-party software conflicts.

For Apple Silicon Macs: Shut down → Press and hold Power Button → Hold until startup options appear → Select startup disk → Hold Shift → Click "Continue in Safe Mode"

For Intel Macs:
Restart → Immediately press and hold Shift →
Hold until login screen appears (may take longer than normal boot) →
Log in → “Safe Boot” text appears top-right of screen

Test all affected keys in TextEdit while in Safe Mode

Safe Mode disables all third-party kernel extensions, login items,
and startup applications — it also clears several system caches.
If previously non-functional keys work correctly in Safe Mode,
a third-party input manager, keyboard extension, or startup item
is causing the failure in normal mode. Identifying and removing
that third-party software resolves the problem without hardware intervention.

Scenario 3 — MacBook Keyboard Typing Wrong Characters

A MacBook keyboard that types the wrong characters — where pressing A produces
a different letter, or where punctuation keys produce numbers, or where
the entire keyboard layout seems shifted — is almost always a software
configuration problem rather than a hardware failure. This is an important
distinction because it means the fix is immediate and requires no tools,
no hardware access, and no data loss.

The three most common causes of wrong-character output are: an accidentally
switched Input Source (keyboard language layout), an enabled Slow Keys or
Sticky Keys accessibility setting, and a Modifier Keys remapping that was
applied at some point and forgotten. Each of these can produce dramatically
wrong character output that feels like hardware damage but resolves
in under 60 seconds once the setting is corrected.

A less common but possible cause is malware or a rogue input manager
intercepting keyboard input and substituting different characters —
this is rare on macOS but has been documented. If none of the settings-based
fixes resolve wrong-character output, checking for unauthorized input
managers and running a malware scan with Malwarebytes for Mac
is the appropriate next step before deeper system intervention.

Why MacBook Keyboard Types Wrong Characters

Input Source accidentally switched to a different language
keyboard layout remaps all physical keys to different characters.
macOS includes keyboard layouts for dozens of languages, each mapping
physical keys to different characters. The US English layout,
the UK English layout, French AZERTY, German QWERTZ, and dozens
of others all assign different characters to the same physical keys.
Switching between Input Sources is triggered by a keyboard shortcut —
Control + Space or Command + Space
depending on your settings — that users frequently activate accidentally
while typing quickly. When the layout switches to French, the A and Q
keys swap positions, the M key moves, and punctuation keys produce
completely different characters. This looks and feels like hardware damage
but is entirely a software layout switch.

Modifier Keys remapping in System Settings reassigns Command,
Option, Control, and Caps Lock to unexpected functions.
macOS allows any modifier key to be remapped to any other modifier key
or to No Action through System Settings. If Modifier Keys remapping
has been applied — intentionally for a specific workflow, by a previous
user of the MacBook, or by a third-party application — Caps Lock might
function as Control, Option might function as Command, or a modifier
key might be set to No Action entirely. This causes unexpected character
output when modifier keys are involved in shortcuts or when Caps Lock
behavior is unexpected. Resetting Modifier Keys to defaults resolves
this immediately.

Sticky Keys accessibility feature changes how modifier keys
interact with subsequent keypresses, producing unexpected characters.
Sticky Keys is an accessibility feature that allows modifier key combinations
to be pressed sequentially rather than simultaneously. When Sticky Keys
is enabled — which can happen by pressing the Shift key five times rapidly —
pressing Shift followed by a letter may not produce what you expect,
because Sticky Keys holds the Shift modifier active until the next
keypress in an unexpected way for users who did not intentionally enable it.
The resulting character output feels random or wrong, particularly
for capitalization and punctuation, and is consistently misidentified
as a hardware keyboard failure.

A third-party application has installed a keyboard input manager
or text substitution rule that intercepts and alters keystrokes
before they reach the active application.
Some productivity applications, typing assistants, and text expanders
install components at the macOS input manager level — allowing them to
intercept and modify keyboard input before any application receives it.
If one of these components malfunctions, becomes corrupted, or enters
a conflict state with another installed component, it can produce
systematically wrong character output that appears to be a keyboard
hardware failure but actually originates in the software input pipeline.
This type of failure survives restarts, SMC resets, and NVRAM resets
because the input manager is reinstalled by its parent application
on each launch.

How to Fix MacBook Keyboard Typing Wrong Characters

Step 1 — Check and correct the active Input Source immediately.

Look at menu bar → Find flag icon or language abbreviation → Click it → If multiple Input Sources listed: select your correct language → If flag icon not visible: Apple Menu → System Settings → Keyboard → Input Sources → Edit → Remove all Input Sources except your primary language → Click Done → Test typing in TextEdit

This is the first step for wrong-character output, full stop.
Look at the menu bar before doing anything else. If you see a flag
that is not your country’s flag, or a language abbreviation that
is not your language, click it and switch back. If you have multiple
Input Sources listed in System Settings, remove all extras —
having multiple Input Sources installed means an accidental keystroke
can switch between them at any time during use.

Step 2 — Reset Modifier Keys to system defaults.

Apple Menu → System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys → For each key (Caps Lock, Control, Option, Command): Confirm dropdown shows the key's own name (e.g., "Caps Lock Key" set to "⇪ Caps Lock") → If any key shows a different assignment: reset to its own function → Click OK → Test keyboard

Check every modifier key mapping in this panel. Common wrong assignments
found in practice: Caps Lock remapped to Control (done intentionally
by a previous user and forgotten), Option remapped to Command,
or Caps Lock set to No Action. Reset each key to its default assignment.
After resetting, test specifically the keys that were producing wrong
characters — modifier key remapping is a frequent silent cause of
unexpected character output.

Step 3 — Disable Slow Keys and Sticky Keys in Accessibility settings.

Apple Menu → System Settings → Accessibility → Keyboard → Slow Keys → Toggle completely OFF → Sticky Keys → Toggle completely OFF → Press Options next to Sticky Keys → Uncheck "Press Shift five times to toggle Sticky Keys" → Click OK → Test keyboard

Disabling the Shift-five-times activation shortcut for Sticky Keys
prevents accidental re-enabling during normal typing. After disabling
both features, test typing specifically with Shift for capitalization,
with Caps Lock, and with keyboard shortcuts — these are the interactions
most affected by Sticky Keys and Slow Keys settings.

Step 4 — Disable Text Replacements and Autocorrect to rule out
substitution conflicts.

Apple Menu → System Settings → Keyboard → Text Replacements → Review all listed replacements → Delete any that may be triggering on your problem keys → Also: Apple Menu → System Settings → Keyboard → Toggle OFF "Correct spelling automatically" → Toggle OFF "Capitalize words automatically" → Toggle OFF "Add period with double-space" → Test keyboard

Text Replacements in macOS automatically substitute defined text strings
when you type their trigger sequences. A poorly configured replacement —
such as a single-letter trigger — can cause wrong-character output every
time that character is typed, because macOS immediately replaces it.
Reviewing and clearing all Text Replacements rules out this subtle
cause of systematic wrong-character output.

Step 5 — Remove third-party input managers and keyboard utilities
from Login Items and System Extensions.

Apple Menu → System Settings → General → Login Items & Extensions → Review "Open at Login" list → Identify and remove: typing assistants, text expanders, keyboard customization apps, input method editors → Also check: System Extensions → Disable any keyboard-related extensions → Restart MacBook → Test keyboard without third-party input managers active

Applications like TextSoap, TypeIt4Me, Rocket Typist, or any custom
input method editor install components that intercept keyboard input
at the system level. Removing them from Login Items prevents them
from loading at startup. If wrong-character output stops after removal,
one of those applications was the source. Reinstall them individually
to identify which specific one caused the conflict.

Step 6 — Run Malwarebytes for Mac to check for unauthorized
input interceptors.

Download Malwarebytes for Mac from malwarebytes.com/mac → Install and launch → Click "Scan Now" → Allow full system scan to complete → Review results → Quarantine and remove any detected threats → Restart MacBook → Test keyboard

If all settings-based fixes have been applied and wrong-character output
persists, a rogue input interceptor — potentially installed by malware
or an untrustworthy application — may be modifying keyboard input
at the system level. Malwarebytes for Mac is free for on-demand scanning
and detects known keyboard interceptors and input-modifying malware.
A clean scan result rules out this cause and confirms the issue is
elsewhere in the system configuration.

Scenario 4 — MacBook Keyboard Not Working After macOS Update

MacBook keyboard failures that appear immediately after a macOS update
are a well-documented pattern. The update itself rarely damages the
keyboard — but several things that happen during and after an update
can cause keyboard failures that did not exist before the update installed.

The most common cause is NVRAM — Non-Volatile Random Access Memory —
which stores keyboard configuration data including modifier key remapping,
keyboard type settings, and input source preferences. A major macOS update
can corrupt an NVRAM entry or write an incompatible value, causing keyboard
behavior to change immediately after the update. An NVRAM reset resolves
this without any data loss.

Third-party keyboard extensions and input managers are another major
post-update keyboard failure source. A kernel extension or input manager
that worked correctly on the previous macOS version may be incompatible
with the updated kernel, causing it to crash or block keyboard input
entirely. The solution is disabling third-party extensions until their
developers release compatibility updates for the new macOS version.

Why macOS Updates Cause MacBook Keyboard Problems

NVRAM data corruption during the update process writes an invalid
keyboard configuration that persists through restarts.
macOS updates rewrite system firmware and can overwrite or corrupt
NVRAM entries in the process. NVRAM stores low-level keyboard settings —
keyboard type identifier, modifier key assignments, input source preferences,
and keyboard layout selection. A corrupted or invalid value in any of
these NVRAM parameters can cause keyboard behavior to change immediately
after an update: modifier keys may stop working, the layout may shift,
or the keyboard may fail to initialize correctly at startup. Because NVRAM
persists through standard restarts, the problem continues until
an explicit NVRAM reset clears the corrupted value.

Third-party kernel extensions and input managers become incompatible
with the updated macOS kernel version and crash or block keyboard input.
macOS updates frequently change kernel interfaces, system call signatures,
and security requirements for kernel extensions (kexts) and system extensions.
Third-party keyboard tools — custom input method editors, keyboard
remapping utilities, typing assistants, accessibility keyboard tools —
often load components at the kernel or system extension level.
When the macOS kernel is updated, these components may fail to load,
crash at startup, or load in a partially functional state that blocks
or corrupts the keyboard input pipeline. The keyboard failure appears
immediately after the update because the incompatible extension was
loaded for the first time under the new kernel version.

System keyboard preference files become incompatible with
the new macOS version’s expected schema and cause keyboard initialization failure.
Each macOS version may use a slightly different schema for keyboard
preference files — particularly for accessibility settings, input
source configuration, and keyboard shortcut definitions. When a major
macOS update (e.g., macOS Sonoma to macOS Sequoia) changes these schemas,
preference files from the previous version may contain values the new
version cannot parse correctly. The result can be keyboard settings that
macOS applies incorrectly or a keyboard initialization sequence that
fails partway through because it encounters an unexpected value
in a preference file it expected to be in a different format.

A failed or incomplete macOS update installation leaves system
keyboard driver files in an inconsistent state between old and new versions.
macOS updates that are interrupted — by a power failure, a forced shutdown,
or a storage error — can leave system files in a mixed state: some files
updated to the new version, others remaining at the old version.
Keyboard driver files in this mixed state may be incompatible with each other,
causing keyboard initialization to fail. This failure is distinct from
the other post-update causes because it does not resolve with NVRAM reset,
SMC reset, or preference file deletion — it requires a complete macOS
reinstall to replace all system files with a consistent, complete version.

How to Fix MacBook Keyboard Not Working After macOS Update

Step 1 — Reset NVRAM immediately after experiencing post-update keyboard failure.

For Intel MacBooks: Shut down completely → Press Power Button → Immediately press and hold: Option + Command + P + R simultaneously → Hold for 20 seconds → Release after second startup chime or after 20 seconds → Allow MacBook to boot normally → Reconfigure: Display resolution, startup disk, time zone if needed → Test keyboard immediately

For Apple Silicon MacBooks:
NVRAM managed automatically →
Perform clean restart: Shut down → Wait 30 seconds →
Power on → Allow full boot → Test keyboard

NVRAM reset is the single most targeted fix for post-update keyboard
failures. It clears all stored keyboard configuration data — including
any corrupted entry written during the update — and forces macOS to
reinitialize keyboard settings from fresh defaults on the next boot.
This resolves modifier key failures, input source configuration problems,
and keyboard type identification issues introduced by update-related
NVRAM corruption. After the reset, macOS may ask you to reconfigure
display resolution and time zone — this is normal and expected.

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

Intel MacBook with T2 chip: Shut down → Hold Left Control + Left Option + Right Shift for 7 seconds → Add Power Button → Hold all four 7 more seconds → Release → Wait 5 seconds → Power on

Intel MacBook without T2 chip:
Shut down → Hold Shift + Control + Option + Power for 10 seconds →
Release → Power on

Apple Silicon MacBook:
Shut down → Wait 30 seconds → Power on

If NVRAM reset alone does not restore keyboard function, adding
an SMC reset addresses the hardware communication layer.
Post-update keyboard failures that survive NVRAM reset but resolve
with SMC reset indicate that the update affected the firmware-level
keyboard interface rather than just stored configuration values.
Perform NVRAM reset and SMC reset sequentially — not simultaneously —
and test keyboard function after each one before proceeding.

Step 3 — Boot into Safe Mode to disable third-party extensions
and identify compatibility conflicts.

Apple Silicon: Shut down → Hold Power Button → Hold until startup options appear → Select startup disk → Hold Shift → Click "Continue in Safe Mode"

Intel:
Restart → Immediately hold Shift →
Hold until login screen with “Safe Boot” label → Log in

Test keyboard in Safe Mode →
If keyboard works: third-party extension is the cause →
Return to normal mode and remove incompatible keyboard tools

Safe Mode disables all third-party kernel extensions and system extensions —
the exact components most likely to be incompatible with a newly updated
macOS. If your keyboard works in Safe Mode but not in normal mode,
the problem is definitively a third-party keyboard extension that is
incompatible with the new macOS version. Remove it, check for a
compatibility update from the developer, or find an alternative tool
that supports the current macOS version.

Step 4 — Delete keyboard preference files to remove schema-incompatible configuration data.

Open Finder → Press Command + Shift + G → Type: ~/Library/Preferences/ → Press Enter → Locate and delete: com.apple.HIToolbox.plist com.apple.keyboard.plist com.apple.symbolichotkeys.plist com.apple.universalaccess.plist → Empty Trash → Restart → Test keyboard

These four preference files contain keyboard configuration data that
may be in a format incompatible with the updated macOS version.
Deleting them forces macOS to regenerate clean, current-version-compatible
versions on the next boot. Include com.apple.universalaccess.plist
in the deletion — this file contains Accessibility keyboard settings
(Slow Keys, Sticky Keys) that may have been written in a format
the new macOS version handles differently, causing unexpected keyboard behavior.

Step 5 — Reinstall macOS using the Update option in Recovery
if all other fixes fail.

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

In Recovery window:
Select “Reinstall macOS [version name]” →
Continue → Agree to license terms →
Select your startup disk →
Click Install →
Allow 30–60 minutes to complete →
DO NOT select “Erase Mac” —
choose Reinstall to preserve all data

A macOS reinstall from Recovery downloads a fresh, complete macOS image
and replaces all system files — including any that were left in an
inconsistent state by a failed or partial update. This resolves
the keyboard driver file inconsistency scenario where mixed old-and-new
system files prevent correct keyboard initialization. Your personal data,
applications, and settings are preserved. Only system files are replaced.
After reinstallation, test the keyboard before restoring any third-party
applications to confirm the base system is clean.

Final Checklist — MacBook Keyboard Not Working — All Fixes

Force restart MacBook first — hold Power Button 10 seconds, wait 30 seconds, restart: Hold Power Button → 10 seconds
Check Input Sources — confirm correct language layout active: Apple Menu → System Settings → Keyboard → Input Sources → Edit
Disable Slow Keys: System Settings → Accessibility → Keyboard → Slow Keys → OFF
Disable Sticky Keys: System Settings → Accessibility → Keyboard → Sticky Keys → OFF
Disable Mouse Keys: System Settings → Accessibility → Pointer Control → Mouse Keys → OFF
Reset Modifier Keys to defaults: System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys → Reset
Connect external keyboard to test if problem is hardware or software
Run Apple Diagnostics to check for hardware faults: Hold D at startup (Intel) or Power Button (Apple Silicon)
Clean under affected keys with compressed air at 75-degree angle — rotate MacBook for all four key edges
Check macOS Keyboard Viewer to confirm which keys are registering: Input menu → Show Keyboard Viewer
Check Apple Keyboard Service Program eligibility for 2015–2019 butterfly MacBook models
Reset NVRAM (Intel): Power on → Hold Option + Command + P + R → 20 seconds
Reset SMC using correct procedure for your specific MacBook model and chip
Delete keyboard preference files: ~/Library/Preferences/ → Delete HIToolbox, keyboard, symbolichotkeys .plist files
Boot in Safe Mode to disable third-party extensions: Hold Shift at startup (Intel) or Power → Shift (Apple Silicon)
Remove third-party keyboard utilities from Login Items: System Settings → General → Login Items & Extensions
Create new user account to test if problem is user-specific: System Settings → Users & Groups → Add Account
Disable Text Replacements and autocorrect: System Settings → Keyboard → Text Replacements
Run Malwarebytes for Mac scan for unauthorized input interceptors
Reinstall macOS via Recovery as final software intervention — choose Update, not Erase

When to Go to Apple Directly

Every fix in this guide addresses software-level, firmware-level,
and physical cleaning interventions that MacBook owners can safely
perform themselves. But some MacBook keyboard failures are genuinely
hardware problems that require professional repair — and continuing
to apply software fixes to a hardware fault wastes time and risks
missing the window for warranty or service program coverage.

Book an Apple Genius Bar appointment or visit an Apple
Authorized Service Provider immediately if:

The MacBook keyboard has had any liquid contact — even a small spill — within the past 72 hours
Multiple keys in a continuous area of the keyboard stopped working simultaneously — suggesting membrane damage rather than individual key debris
Keys register input without being pressed — phantom keypresses appearing in documents spontaneously
The keyboard produces correct output in macOS Recovery but fails in normal mode AND all software fixes (Safe Mode, preference deletion, reinstall) have been applied without success
Apple Diagnostics returns a keyboard-specific error code during hardware testing
The MacBook was dropped or impacted before the keyboard failure appeared
Your MacBook is a 2015–2019 butterfly keyboard model — check Apple’s Keyboard Service Program eligibility before paying for any repair
The keyboard fails consistently in Safe Mode, Recovery mode, and with an external monitor and keyboard connected — pointing to a logic board fault
Individual key caps are physically broken, loose, or missing from their retainer mechanisms

Phantom keypresses — keys registering without being touched — are a
specific hardware red flag for liquid damage or membrane short circuits.
Do not continue using a MacBook with phantom keypresses for sensitive
work — the same membrane short that causes phantom keys can cause
accidental keystrokes in secure fields and financial applications.

For 2015–2019 butterfly keyboard MacBook owners: Apple’s Keyboard
Service Program may provide a free keyboard assembly replacement
regardless of your warranty status. Check eligibility at
Apple’s Keyboard Service Program page
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
Keyboard completely silent — no keys work at all	SMC firmware freeze or frozen HID input manager process	Force restart (hold Power 10 seconds), then SMC reset	Full keyboard function restores in most cases after SMC reset
One or two specific keys stopped working — rest fine	Physical debris under butterfly/scissor mechanism or liquid residue	Compressed air at 75-degree angle, all four key edges, 3 bursts each	Debris-caused key failures resolve immediately after cleaning in most cases
Keys typing wrong characters or shifted symbols	Input Source switched to wrong language layout accidentally	Click flag icon in menu bar → switch back to correct language	Correct character output restores instantly on layout switch
Keyboard stopped working right after macOS update	NVRAM corruption during update or incompatible third-party extension	NVRAM reset (Intel) or SMC-equivalent restart (Apple Silicon)	Most post-update keyboard failures resolve after NVRAM + SMC reset
Keyboard works in Safe Mode but not in normal mode	Third-party keyboard extension or input manager conflict	Remove keyboard utilities from Login Items and System Extensions	Keyboard function restores after removing conflicting extension
Modifier keys (Shift, Command, Option) behaving wrong	Modifier Keys remapping or Sticky Keys enabled in Accessibility	System Settings → Keyboard → Modifier Keys → Reset to defaults	Correct modifier key behavior restores immediately after reset
Keys working in new user account but not in regular account	Corrupted user-specific keyboard preference files	Delete HIToolbox.plist, keyboard.plist from ~/Library/Preferences/	Fresh preference files regenerate with correct defaults on restart
All software fixes applied — keyboard still not working	Hardware fault — ribbon cable, membrane failure, or liquid damage	Book Apple Genius Bar — free hardware diagnostic and Service Program check	Hardware fault identified, Keyboard Service Program may cover free repair

Conclusion — How to Fix MacBook Keyboard Not Working

MacBook keyboard not working covers a wide range of problems —
complete silence, specific key failures, wrong characters, and post-update
breakdowns — each with a different root cause and a different targeted fix.
The most important step in resolving any keyboard failure is correctly identifying
which category your problem falls into before applying any fix.

For complete keyboard non-response, the sequence is force restart →
external keyboard test → SMC reset → Recovery boot test →
preference file deletion → macOS reinstall. Most complete keyboard
failures resolve at the SMC reset stage. For specific key failures,
the sequence is compressed air cleaning → Keyboard Viewer test →
Apple Service Program check → isopropyl cleaning for liquid residue.
For wrong characters, Input Source and Accessibility settings resolve
the vast majority of cases in under two minutes.

For post-update keyboard failures, NVRAM reset and Safe Mode testing
resolve most cases by addressing the two most common causes —
NVRAM corruption and incompatible third-party extensions — without
any data loss or complex intervention.

If every fix in this guide has been applied carefully and the keyboard
still does not work correctly, you are dealing with hardware.
For 2015–2019 butterfly keyboard models, check the Apple Keyboard
Service Program eligibility before paying for any repair — it may cover
a free replacement. For all MacBook models, Apple in-store diagnostics
are free. Apple diagnostics are free. Go before spending money on guesses.

FAQ — MacBook Keyboard Not Working

Can I use my MacBook with an external keyboard while the built-in keyboard is broken?

Yes — macOS supports external keyboards connected via USB-C, USB-A with an adapter,
or Bluetooth without any configuration changes. The Apple Magic Keyboard connects
via USB-C for wired use or pairs via Bluetooth and works identically to the
built-in keyboard including all Function keys, Touch ID (on compatible Magic Keyboards),
and all keyboard shortcuts. Third-party mechanical keyboards also work through USB
without additional drivers in most cases. Using an external keyboard while arranging
repair is the most productive solution for a hardware keyboard failure.

Will resetting the SMC delete any of my files or applications?

No — the SMC reset does not touch your storage, your user files, your applications,
or your macOS installation. It only resets low-level hardware management firmware
to its default state. Your documents, photos, applications, and settings are
completely unaffected by an SMC reset. The reset may change a few system-level
hardware settings — fan behavior, power management, and keyboard LED brightness
on older models — but none of these affect your data or workflow.

My MacBook is a 2018 model and the keyboard randomly types double letters — is this a known issue?

Yes — key repeat issues on 2016–2019 butterfly MacBook models are specifically
covered by Apple’s Keyboard Service Program. Double letter output, stuck keys,
and unresponsive keys on these models qualify for free keyboard assembly replacement
regardless of warranty status. Visit Apple’s support page and enter your serial
number to confirm eligibility. If your MacBook qualifies, book an Apple
Genius Bar or Authorized Service Provider appointment before spending money
on any third-party repair or purchasing an external keyboard as a permanent solution.

How do I clean my MacBook keyboard without damaging it?

Apple’s recommended MacBook keyboard cleaning method uses compressed air held
at a 75-degree angle — almost vertical — with the MacBook tilted so gravity
assists debris removal. Use short 2-second bursts along each edge of the key
you are cleaning, rotating the MacBook to address all four edges.
Never spray compressed air with the MacBook lying flat — debris gets pushed
deeper into the mechanism. Never use water, household cleaning sprays,
or any liquid directly on the keyboard. For surface grime on key caps,
a cloth lightly dampened with 70%+ isopropyl alcohol — wrung out completely
before contact — is safe for wiping key cap surfaces.

Why does my MacBook keyboard work at the login screen but stop working after login?

This specific symptom — keyboard works before login, fails after — almost always
points to a third-party input manager, keyboard utility, or login item that loads
after the user session starts and conflicts with the keyboard input pipeline.
Boot into Safe Mode (hold Shift at startup on Intel, or Power → Shift on Apple Silicon) —
Safe Mode prevents all login items and third-party 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 test after each removal
to identify the specific conflicting application.

Is it worth replacing the keyboard on an older MacBook myself?

MacBook keyboard self-replacement is not recommended for most users.
The MacBook keyboard assembly is integrated with the top case on most models —
replacing the keyboard requires replacing the entire top case (keyboard, trackpad,
and battery assembly combined), which is a complex procedure with many fragile
ribbon cable connections and screw sizes. The parts cost and risk of damage
during reassembly often exceeds the cost of professional Apple Authorized
Service Provider repair. The exception is older Intel MacBook Pro models
from 2012–2015 where the keyboard is a separate component —
iFixit provides guides and parts for these models specifically.

My MacBook keyboard started working again on its own — should I still investigate the cause?

Yes — a keyboard that fails and then recovers spontaneously without any
intervention is displaying intermittent behavior, which is more concerning
than a consistent failure. Intermittent failures typically indicate a
marginal physical connection — a partially disconnected ribbon cable
that makes contact unreliably, or a debris particle that shifted position
and temporarily stopped blocking the key contact. These problems recur
and generally worsen over time. At minimum, run Apple Diagnostics to check
for hardware error codes, and clean under any keys that previously failed
with compressed air. If the failure recurs, book Apple service before
the problem progresses to complete failure at an inconvenient time.

Stephen Giffin

I’m the founder of MACSWIRE, an innovative platform dedicated to exploring the intersection of technology and creativity. My passion lies in pushing the boundaries of what’s possible, and I’m thrilled to share my insights with you.

With a deep-rooted belief that technology should empower, not constrain, I’ve curated a space where curious minds can connect, learn, and grow. MACSWIRE is more than just a blog; it’s a vibrant community where ideas flourish and innovation thrives.

Join me on this exciting journey as we delve into the future of technology and its profound impact on our lives. Let’s dream big, create freely, and connect with the world around us. Together, we can unlock our true potential and shape a brighter tomorrow.

M	T	W	T	F	S	S
				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30	31