MacBook Keyboard Not Working? Every Fix Explained
A dead MacBook keyboard can mean anything from a simple software glitch to the infamous butterfly mechanism failure. Before you panic about an expensive repair, work through these fixes in order β software first, then cleaning, then hardware diagnosis.
As an Amazon Associate we earn from qualifying purchases. This costs you nothing extra and helps keep this site free.
β‘ Keyboard Cleaning Tools
Most stuck keys are crumbs β clean before you replace.
Blow out crumbs β solves most stuck keys
Reach under keys for stubborn debris
Prevents future crumbs and dust
Microfiber + brush + alcohol wipes
π First: Identify the Problem
Before diving into fixes, figure out exactly what is happening:
- Entire keyboard dead: No keys respond at all β likely software freeze, SMC issue, or ribbon cable.
- Some keys stuck or unresponsive: Usually debris under the keys or butterfly mechanism failure.
- Keys type wrong characters: Keyboard layout or language setting issue.
- Keyboard works intermittently: Loose ribbon cable connection or liquid damage.
- Backlight works but no input: Software issue β the hardware is powered but not communicating.
π οΈ Tools You'll Need
- Compressed Air Duster
- Anti-Static Brush + Q-Tip Kit
- 99% Isopropyl Alcohol
- MacBook Silicone Keyboard Cover
As an Amazon Associate we earn from qualifying purchases.
π Difficulty & Time
π§ Fix Stuck or Unresponsive Keys: Step by Step
Step 1: Power Off + Hold Upside Down
Power off the MacBook. Hold it at a 75Β° angle, screen-side down. Crumbs and dust fall out gravity-aided.
Step 2: Compressed Air in Z Pattern
Spray short bursts directly across the keyboard in a Z pattern (top-left to top-right, diagonal to bottom-right, then bottom-left to bottom-right). Repeat 2β3 times. Most stuck keys release after this.
Step 3: Target the Specific Sticky Key
If one key is still sticky: angle compressed air bursts directly at all 4 sides of that key. Use the brush to sweep around the key edges.
Step 4: Sticky-Liquid Residue Cleanup
If a sticky drink (soda, juice) caused the issue: dip a Q-tip in 99% isopropyl alcohol (lightly damp, NOT wet) and gently work around the key edges. The alcohol dissolves dried sugars without leaving residue.
Step 5: Test in Safe Mode
If keys are still misbehaving software-side: boot in Safe Mode (Apple Silicon: hold power until startup options, hold Shift, click Continue). If keys work in Safe Mode but not normally, a third-party app/driver is intercepting them.
Step 6: Reset SMC / NVRAM
For unresponsive keys: Apple Silicon resets SMC by powering off for 30 sec then on. Intel: reset NVRAM with cmd+option+P+R held during boot. Resets keyboard controller state.
β οΈ Common Mistakes to Avoid
- Prying the key off (Apple's scissor mechanism breaks easily β you're now buying a $349 keyboard)
- Spraying alcohol UNDER the keys (can short the keyboard if it pools)
- Skipping the gravity test (most stuck keys release with just upside-down + air)
- Continuing to use after a liquid spill (causes corrosion of contacts)
π₯ When to Call a Pro
Apple replaces the entire top case (keyboard + trackpad + battery + speakers + Touch ID) as one unit β $349 out of warranty, $129 with AppleCare+ accidental damage. If multiple keys are dead or you're seeing sticky residue inside, get the top case replaced before deeper damage occurs.
π§ Fix 1: Restart Your MacBook
If the keyboard is completely unresponsive, the system may be frozen. Press and hold the Power button for 10 seconds to force shut down. Wait 10 seconds, then press Power to restart. This resolves most temporary keyboard failures caused by software hangs or kernel panics.
π§ Fix 2: Check for macOS Updates
Apple has shipped macOS updates specifically to address keyboard input bugs. If you can navigate using an external mouse or trackpad, go to System Settings → General → Software Update and install any available updates.
π§ Fix 3: Check Accessibility Settings
Accessibility features can make the keyboard seem broken when they are accidentally enabled:
- Slow Keys: Requires you to hold each key for a delay before it registers. Go to System Settings → Accessibility → Keyboard → Slow Keys. Make sure this is OFF.
- Mouse Keys: Turns keyboard keys into mouse controls. Check Accessibility → Pointer Control → Mouse Keys. Turn OFF.
- Sticky Keys: Makes modifier keys "stick" β can cause confusing behavior. Accessibility → Keyboard → Sticky Keys. Turn OFF.
If you cannot use the keyboard to navigate settings, connect a USB keyboard temporarily or use Voice Control (Accessibility → Voice Control).
π§ Fix 4: Delete Keyboard Preferences
Corrupted preference files can cause keyboard misbehavior. Open Finder → Go → Go to Folder and type ~/Library/Preferences/. Look for files named com.apple.keyboardtype.plist and delete them. Restart your Mac β macOS will regenerate fresh preferences.
π§ Fix 5: Reset SMC (Intel) or Restart (Apple Silicon)
The SMC controls keyboard communication on Intel Macs. If the keyboard is not responding after a normal restart:
- Intel MacBook with T2 chip (2018β2020): Shut down. Hold Control + Option + Shift (left side) for 7 seconds, then also press and hold Power for 7 more seconds. Release all keys, wait, then power on.
- Intel MacBook (pre-2018): Shut down. Hold Shift + Control + Option + Power for 10 seconds. Release, then power on.
- Apple Silicon (M1βM4): Simply shut down completely (not just sleep) and restart after 30 seconds. There is no separate SMC.
π§ Fix 6: Clean the Keyboard with Compressed Air
Debris under the keys is one of the most common causes of stuck or unresponsive keys. Apple's official cleaning method:
- Hold the MacBook at a 75-degree angle (nearly vertical)
- Spray compressed air across the keyboard in a left-to-right pattern
- Rotate the MacBook to one side and spray again
- Rotate to the other side and spray a third time
Important: Use short bursts. Do not turn the can upside down (liquid propellant will spray out). Do not use a vacuum β the suction can damage key mechanisms.
π§ Fix 7: Test with an External Keyboard
This is the most important diagnostic step. Connect a USB or Bluetooth keyboard to your MacBook. If the external keyboard works perfectly, the problem is definitely with the built-in keyboard hardware β not software. If the external keyboard also has issues, the problem is software or a deeper logic board fault.
π§ Fix 8: Boot into Safe Mode
Safe Mode disables third-party kernel extensions and drivers that might interfere with keyboard input.
- Apple Silicon: Shut down. Press and hold Power until "Loading startup options" appears. Select your drive, then hold Shift and click "Continue in Safe Mode."
- Intel: Restart and immediately hold Shift until the login window appears.
If the keyboard works in Safe Mode, a third-party app or driver is the cause. Uninstall recently installed software β keyboard remappers (Karabiner-Elements), macro apps, and third-party input methods are common culprits.
β οΈ Fix 9: Check for Butterfly Keyboard Issues
The butterfly keyboard mechanism used in these models is notoriously failure-prone:
- MacBook Pro 13" and 15" (2016β2019)
- MacBook 12" (2015β2017)
Symptoms include stuck keys, repeating characters, and keys that feel "mushy" or do not click. Apple acknowledged the defect and ran a Keyboard Service Program offering free repairs. While the program has officially ended for most models, Apple has sometimes made exceptions β it is worth visiting or calling an Apple Store to ask, especially if the failure is clearly the butterfly mechanism.
If Apple will not cover it, third-party repair shops can replace individual butterfly key switches or the entire keyboard assembly at a fraction of Apple's price.
π When It Is Hardware: Professional Repair
If none of the software fixes or cleaning helped, and an external keyboard works fine, you are looking at a hardware repair. On modern MacBooks, the keyboard is riveted to the top case, so replacing it means replacing the entire top assembly (palmrest + keyboard + sometimes battery). This is not a DIY job for most people.
π PC Medics of NJ
MacBook keyboard replacement and liquid damage repair for all models.
Call: 856-914-1074
Free diagnosis β we will identify the exact cause before any repair!
π Recommended Products
Industry-standard compressed air for keyboard cleaning
Best external keyboard for MacBook β works while built-in keyboard is being repaired
Prevent dust and debris from getting under keys in the future