← Back to Guides All MacBooks

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.

⏱️ 10–30 minutes πŸ’ͺ Easy–Moderate πŸ’° Free–$$$

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.

Compressed Air Duster (electronics-safe)
Blow out crumbs β€” solves most stuck keys
Check Price →
Anti-Static Brush + Q-Tip Kit
Reach under keys for stubborn debris
Check Price →
Silicone Keyboard Cover
Prevents future crumbs and dust
Check Price →
Macbook Cleaning Kit
Microfiber + brush + alcohol wipes
Check Price →

πŸ” 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.
πŸ› οΈ Need the right tools? The iFixit Pro Tech Toolkit has everything for this repair. Check Price β†’

πŸ› οΈ Tools You'll Need

As an Amazon Associate we earn from qualifying purchases.

πŸ“‹ Difficulty & Time

⏱️ 10–20 min πŸ’ͺ Easy πŸ’° Free fix saves $349 keyboard replacement

πŸ”§ 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.

Ship It In for Repair →

πŸ”§ 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:

  1. Hold the MacBook at a 75-degree angle (nearly vertical)
  2. Spray compressed air across the keyboard in a left-to-right pattern
  3. Rotate the MacBook to one side and spray again
  4. 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

Falcon Dust-Off Compressed Air (4-Pack)
Industry-standard compressed air for keyboard cleaning
Check Price β†’
Apple Magic Keyboard with Touch ID
Best external keyboard for MacBook β€” works while built-in keyboard is being repaired
Check Price β†’
MacBook Keyboard Cover (Silicone)
Prevent dust and debris from getting under keys in the future
Check Price β†’

Browse All Tools & Parts β†’

πŸ“– Related Guides

πŸ“¦ Mail-In Keyboard Repair

Keyboard replacement is tricky β€” let professionals handle it:

Get Repair Quote β†’
Can't fix it yourself? Get a Mail-In Repair Quote β†’ πŸ“ž (856) 914-1074