"I'm typing on my MacBook but nothing shows up." "My Magic Keyboard suddenly disconnected." "Only certain keys stopped working." — When a Mac keyboard stops responding, the cause can range from a connection issue or macOS software setting to an IME glitch or liquid damage. This article covers macOS Sonoma / Sequoia on both Apple Silicon (M1/M2/M3/M4) and Intel Mac, including the built-in MacBook keyboard, Magic Keyboard, Bluetooth keyboards, and USB-C keyboards — walking through each symptom pattern step by step. Use the Mac Troubleshooting Guide | Fixes Organized by Symptom alongside this article and work through the steps from the top.
Table of Contents
- Diagnosing First: Symptom Patterns and Causes
- Getting Started with Mouse Only (When the Keyboard Is Completely Dead)
- Basic Hardware Checks (External Keyboard)
- Restarting macOS and Resetting SMC / NVRAM
- Reviewing Keyboard Settings
- Keyboard Freezes Only While Typing (IME-Related)
- Boot into Safe Mode to Isolate the Issue
- Login Items, Extensions, and Background Apps
- Built-in Keyboard Issues Specific to MacBook
- macOS Recovery / Reinstall
- If Nothing Works: Deciding on Repair
- Summary: Troubleshooting Order Checklist
Diagnosing First: Symptom Patterns and Causes
When we say "the keyboard isn't working," the cause and fix vary dramatically depending on which keyboard, when it happens, and how many keys are affected. Start by identifying your specific symptom.
All Keys Unresponsive (Built-in Keyboard)
If the entire built-in MacBook keyboard has stopped working, suspect either a macOS software glitch or hardware failure such as a torn ribbon cable or liquid damage. Plug in an external USB keyboard and try typing — if that works, the problem is likely software (a driver reload may fix it) or a physical ribbon cable issue. If the external keyboard also fails to produce input, the culprit is likely a macOS setting or a frozen input method (IME).
All Keys Unresponsive (External Keyboard)
If a Magic Keyboard or USB-C keyboard has gone completely silent, a connection problem is almost always the cause. For Bluetooth, the pairing may have dropped; for USB-C, try unplugging and replugging or switching ports; for the Magic Keyboard, check the battery. Also confirm whether the mouse or trackpad is still responding — if neither works, macOS may be frozen.
Only Certain Keys Not Working
When only specific keys have a problem — "the A key won't type," "the number row is dead," "the spacebar doesn't work" — the cause is usually a physical switch failure or debris stuck under the key, or an incorrectly configured modifier key remapping. Accessibility Mouse Keys (which redirect numeric keypad input to mouse movement) or an accidentally swapped control key assignment can also make it look like certain keys aren't working. Check Mac Keyboard Shortcuts to confirm the expected behavior and help determine whether the issue is settings-related.
Keyboard Stops Working Mid-Typing
If the keyboard suddenly becomes unresponsive while you're typing and then recovers after a few seconds, the most common cause is a temporary freeze of the input method (IME). This is especially common with Google Japanese Input or ATOK; restarting the process from Activity Monitor almost always fixes it. For a Bluetooth keyboard, momentary radio interference on the same frequency band is also worth considering.
Works on the Sign-in Screen but Not After Login
If you can type your password on the lock or sign-in screen but the keyboard stops working once you're at the desktop, a login item is interfering. Karabiner-Elements and similar tools that intercept keystrokes at a low level can completely block input when running an old version that isn't compatible with the current macOS release. This is especially common right after a major macOS upgrade.
Not Working After Sleep
If the keyboard is unresponsive right after opening the lid or waking from sleep — but works fine after waiting a moment or restarting — the cause is either Bluetooth reconnection taking too long or a macOS sleep/wake cycle bug. A Magic Keyboard normally reconnects within 2–3 seconds; if it takes longer, resetting the pairing is effective.
After Spilling a Liquid
If certain keys became unresponsive or sticky after spilling coffee or water, you're dealing with liquid ingress. Continuing to use the Mac while it's still wet accelerates corrosion of the logic board, so follow the emergency steps below (power off and let it dry face-down) immediately.
Quick Reference Chart by Symptom
| Symptom | Main Cause | First Thing to Try |
|---|---|---|
| Built-in keyboard dead, external also unresponsive | macOS / IME freeze | Restart / Accessibility Keyboard |
| Built-in dead, external USB works | Ribbon cable / software | Restart → Apple Support |
| Magic Keyboard completely unresponsive | Dead battery / Bluetooth disconnect | Check charge → Re-pair |
| Only some keys unresponsive | Physical failure / settings error | Check modifier key settings → compressed air |
| Keyboard stops mid-typing | IME freeze | Restart the IME process |
| Only unresponsive after login | Background app like Karabiner | Verify in Safe Mode |
| Unresponsive after sleep | Bluetooth reconnect delay | Wait a few seconds → Re-pair |
| Wrong key layout (@ types as [, etc.) | Wrong input source setting | System Settings → Keyboard → Input Sources |
Getting Started with Mouse Only (When the Keyboard Is Completely Dead)
Even when the keyboard is completely unresponsive, you can still enter passwords and change settings using only mouse or trackpad clicks with macOS's Accessibility Keyboard (on-screen keyboard). Learn these steps first.
How to Open the Accessibility Keyboard
Here's how to launch the Accessibility Keyboard on macOS Sonoma / Sequoia.
- Apple menu (the in the top-left corner) → System Settings
- Select Accessibility from the left sidebar
- Scroll down the right pane and click Keyboard
- Turn on Accessibility Keyboard
Once enabled, a virtual keyboard appears on screen. Click each key to type. If you need to switch input languages, use the language-switcher button in the top-right corner of the on-screen keyboard. You can also try pressing Option + Cmd + F5 from the menu bar Accessibility shortcut to invoke the Accessibility Keyboard — but if the physical keyboard is completely dead, use the mouse steps above instead.
Restarting Using Only the Menu Bar and Trackpad
To restart without a keyboard, use the Apple menu. Click the logo in the top-left corner → click Restart…. When the confirmation dialog appears, click "Restart" to proceed. At the password entry screen after a restart, an Accessibility Keyboard icon may appear in the bottom-right corner of the login screen. If it doesn't appear, you'll need to enable the Accessibility Keyboard in advance using the steps above.
Basic Hardware Checks (External Keyboard)
When an external keyboard such as a Magic Keyboard or USB-C keyboard isn't responding, start with basic physical connection checks.
Reconnecting USB-C / Lightning and Trying a Different Port
If a USB-C keyboard isn't responding, fully unplug the cable, wait a few seconds, and plug it into a different USB-C port. MacBook Pro and Mac mini have multiple Thunderbolt ports, and simply switching ports sometimes resolves the issue.
If you're connecting through a USB-C hub or docking station, plug directly into a port on the Mac to confirm it works. Hubs can cause recognition failures due to insufficient power delivery or compatibility issues. When connecting a Magic Keyboard (Lightning model) via cable, use an official Apple or Apple-certified Lightning cable.
Magic Keyboard Battery Level and Power Switch
The Magic Keyboard (USB-C charging model) can drop the connection suddenly when the battery dies. Connect it via USB-C cable to charge and continue using it, or wait for it to finish charging before reconnecting.
You can check the battery level in System Settings → Bluetooth. A battery icon appears next to your paired Magic Keyboard's name showing the approximate charge. The keyboard may disconnect unexpectedly when the charge falls below around 10–15%.
Also, try sliding the power switch on the back of the Magic Keyboard off, waiting a few seconds, then sliding it back on. Toggling the power switch resets the Bluetooth stack and can restore the connection.
Resetting the Bluetooth Pairing
If the Bluetooth pairing data becomes corrupted, the device may show as connected in System Settings yet produce no input. Re-pairing usually fixes this.
- Open System Settings → Bluetooth
- Click the "…" button next to the Magic Keyboard → click "Forget This Device"
- Confirm by clicking "Forget Device" in the dialog
- Slide the Magic Keyboard's power switch off, then back on (it will enter pairing mode)
- When the Magic Keyboard appears in the "New Devices" list on the Bluetooth screen, select it to pair
If you use the keyboard with multiple Macs, it may have switched to a different Mac. Re-pair it from the Bluetooth settings on the Mac you want to use.
Testing on a Different Mac
If possible, try connecting the keyboard to a different Mac — this is the most definitive way to isolate the issue. If it works on another Mac, the problem is with the settings or software on the original Mac. If it doesn't work on the other Mac either, the keyboard itself is almost certainly defective.
Restarting macOS and Resetting SMC / NVRAM
A Regular Restart Fixes Many Issues
When the keyboard suddenly stops working, restarting is the most effective and effortless fix. Temporary macOS software glitches, a frozen Bluetooth stack, and a runaway IME process are all resolved by a restart in most cases. If the keyboard is completely unresponsive, use the Accessibility Keyboard or the Apple menu to restart.
If the problem comes back immediately after restarting, continue to the next steps.
Apple Silicon Has No SMC / NVRAM Concept
On Macs with M1, M2, M3, or M4 chips, the SMC (System Management Controller) is integrated into the chip itself — there is no manual reset procedure for users. NVRAM is also managed automatically by macOS, so the Intel Mac "SMC reset" and "NVRAM reset" steps do nothing on Apple Silicon.
To get the equivalent effect of an SMC reset on Apple Silicon, simply hold the power button for 10 or more seconds to force a shutdown, wait a few seconds, then restart normally. This resets the hardware management chip along with everything else.
How to Reset the SMC on Intel Mac
The SMC is an Intel Mac–specific chip that manages power, cooling, keyboard backlighting, and more. It can also help with keyboard-related problems.
Intel Mac without T2 chip (MacBook Air 2017 or earlier, MacBook Pro 2017 or earlier, etc.):
- Shut down your Mac
- With the AC adapter connected, simultaneously hold Left Shift + Left Ctrl + Left Option + Power button for 10 seconds
- Release all keys, then press the power button once to start up normally
Intel Mac with T2 chip (MacBook Air 2018–2020, MacBook Pro 2018–2020, etc.):
- Shut down your Mac
- Hold Right Shift + Left Ctrl + Left Option, then add the Power button and hold all four simultaneously for 7 seconds
- Release all keys, then press the power button to start up normally
iMac / Mac mini (without T2): Shut down → unplug the AC cable → wait 15 seconds → plug the AC cable back in → wait 5 seconds → press the power button. The SMC resets during this process.
How to Reset NVRAM / PRAM on Intel Mac
NVRAM is a small memory that stores modifier key assignments, volume, time zone, and similar settings. Corruption here can cause erratic keyboard behavior. This step is unnecessary and has no effect on Apple Silicon Macs.
- Shut down your Mac
- Immediately after pressing the power button, hold Cmd + Option + P + R simultaneously
- Keep holding until you hear the startup chime twice (or see the Apple logo appear twice)
- Release the keys and normal startup will continue
Intel MacBooks with Touch ID (2016–2020) may have the startup chime disabled by default. In that case, hold Cmd + Option + P + R for about 20 seconds before releasing. After the NVRAM reset, check System Settings → Keyboard to confirm that your modifier key assignments haven't been cleared.
Reviewing Keyboard Settings
Incorrect macOS Accessibility or Keyboard settings can produce symptoms that look like a broken keyboard.
System Settings → Keyboard → Input Sources
If symbols are coming out wrong — for example, @ types as [ or Shift+2 produces " instead of @ — the input source layout is mismatched. The system is treating a keyboard with one layout as if it has a different layout.
- System Settings → Keyboard
- Click the "Edit…" button next to Input Sources
- Confirm that the correct input source for your keyboard layout is selected
- If an unwanted input source is mixed in, remove it
Cmd + Space (or Ctrl + Space) can accidentally switch the input source to the wrong layout. If multiple input sources are registered, an inadvertent keystroke may have switched it.
Accidentally Enabled Slow Keys or Mouse Keys
When Slow Keys is turned on, a key must be held down for a set amount of time before the input registers. This looks like "I'm pressing keys but nothing is being typed." When Mouse Keys is turned on, the numeric keypad is remapped to control the mouse cursor, which looks like "numbers won't type."
Check both settings in Accessibility.
- System Settings → Accessibility
- Click Keyboard in the left sidebar
- Confirm Slow Keys is off
- Go to Pointer Control (also inside Accessibility) → confirm Mouse Keys is off
Modifier Key Remapping and Control Key Swaps
If modifier key remapping in System Settings has been changed accidentally — for example, Caps Lock is mapped to Command, or Option and Cmd are swapped — you'll see symptoms like "some keys aren't working" or "capitalization turns on without pressing Shift."
- System Settings → Keyboard
- Click the "Modifier Keys…" button next to the keyboard type
- Confirm that Caps Lock, Control, Option, Command, and Fn are all set to their defaults
- If anything was changed, restore each key's dropdown to the correct action
Key Repeat Settings
If "holding a key doesn't repeat the character" or "only one character appears," check the key repeat settings.
- System Settings → Keyboard
- Check the "Key Repeat Rate" and "Delay Until Repeat" sliders
- If "Delay Until Repeat" is set to the slowest (longest) value, you'll have to hold a key for a very long time before it starts repeating
Keyboard Freezes Only While Typing (IME-Related)
A bug or freeze in the input method (IME) can cause the keyboard to stop responding only while text input is active. This can happen with both the macOS built-in input method and third-party IMEs.
Restarting the Input Method Process
If the macOS built-in input method has frozen, restarting it via Activity Monitor is the quickest fix.
- Launch Spotlight (Cmd + Space) → type "Activity Monitor" (if the keyboard is dead, launch it from the Dock or Finder)
- Type "Japanese" or "JapaneseIM" in the search bar to find the IME process
- Select the process, click the "×" button in the top-left, and choose "Force Quit"
- macOS automatically restarts the IME process (the input source returns within a few seconds)
For Google Japanese Input, search for "GoogleJapaneseInput"; for ATOK, search for "ATOK" — then restart the same way.
Toggling Live Conversion On and Off
The Live Conversion feature of macOS's built-in Japanese input method — which automatically selects conversion candidates in real time as you type — can malfunction in certain apps, making it look as if keys aren't registering or characters are disappearing.
Open the input menu (the input source icon in the menu bar) → uncheck "Live Conversion" and see whether the issue improves. Alternatively, go to System Settings → Keyboard → Input Sources, select Japanese, and toggle the Live Conversion checkbox there.
Conflicts Between Third-Party IMEs and macOS Input
When using a third-party IME such as Google Japanese Input or ATOK, conflicts with the macOS built-in input method switching can produce keyboard-freeze symptoms.
- If both "Japanese (macOS built-in)" and "Google Japanese Input" are registered as input sources, Cmd + Space can accidentally switch between them and create confusion
- Removing all Japanese input sources except the one you want to use will stabilize things
- ATOK Passport (the annual subscription version) tends to receive macOS compatibility updates faster. Older versions of ATOK can malfunction after a major macOS upgrade
Boot into Safe Mode to Isolate the Issue
Safe Mode starts macOS without loading kernel extensions, login items, or font caches. If the keyboard works normally in Safe Mode, something loaded during a normal startup is interfering. The steps are completely different for Apple Silicon and Intel Mac.
Safe Mode Steps for Apple Silicon
- Fully shut down your Mac
- Hold the power button until "Loading startup options…" appears
- When your startup disk (Macintosh HD) appears, hold Shift and click "Continue"
- Keep holding Shift — the login screen will show "Safe Boot" in the top-right corner
Safe Mode Steps for Intel Mac
- Shut down or restart your Mac
- Immediately after pressing the power button, hold the Shift key
- Release Shift when the login screen shows "Safe Boot"
If It Works in Safe Mode, What's the Cause?
- Keyboard works normally in Safe Mode → A login item, kernel extension (kext), or cache loaded during normal startup is the culprit. Proceed to the background app disabling steps in the next section.
- Still not working in Safe Mode → The problem is at the hardware level or deep within macOS. Proceed to macOS Recovery repair.
Because Safe Mode switches to a basic graphics driver and prevents keyboard-hooking tools like Karabiner from running, it clearly distinguishes software from hardware causes. See also 5 Ways to Force Quit an App on Mac | Shortcuts, Terminal, and Activity Monitor for related troubleshooting.
Login Items, Extensions, and Background Apps
Once you've confirmed that the keyboard works in Safe Mode, the next step is to identify and disable the software causing the problem during normal startup.
Disabling Login Items from System Settings
- System Settings → General → Login Items & Extensions
- Turn all apps off in the "Open at Login" section
- Restart normally and check whether the keyboard works correctly
- If it does, re-enable login items one at a time, restarting after each, to identify the culprit
Also check the "Extensions" section of "Login Items & Extensions." This is where virtualization software, VPN clients, and apps with kernel drivers appear. Disable anything suspicious and restart.
Impact of Low-Level Tools Like Karabiner-Elements
Karabiner-Elements intercepts keyboard input at a low level. If an old version that isn't compatible with the current macOS release is installed, it can completely block all keyboard input. If the problem started right after a major macOS upgrade, suspect Karabiner-Elements first.
- Temporarily uninstall Karabiner-Elements (or confirm via Safe Mode that it isn't running there) and check whether the symptoms disappear
- Download and install the latest version compatible with your macOS from the official site (karabiner-elements.pqrs.org)
- Other tools that hook into keyboard input — BetterTouchTool, Keyboard Maestro, TextExpander, Alfred — should also be temporarily disabled to narrow down the cause
Built-in Keyboard Issues Specific to MacBook
Here are the built-in keyboard problems unique to MacBook and how to address them.
Blowing Out Dust and Crumbs with Compressed Air
Dust or food crumbs trapped under the keys can cause a key to register as stuck (always pressed) or, conversely, to become completely unresponsive.
- Use a can of compressed air and blow from the side at a slight angle — not straight down
- Blowing directly downward can dislodge parts beneath the keycap
- Hold the Mac sideways at different angles to help debris fall out
MacBook Pro models from 2016–2019 (the butterfly keyboard generation) are known for keys jamming from dust and tiny particles. Apple ran a keyboard repair program for affected models (some have since ended). If you have a butterfly-generation Mac with keys that keep sticking, contact Apple Support to check whether it qualifies.
What to Do Immediately After Spilling Liquid
If you spill coffee or water on your MacBook, act immediately with the following steps. Every second of delay increases the risk of logic board corrosion.
- Immediately hold the power button to shut down (even if you'll lose unsaved work — power off first)
- Unplug the charging cable and all USB devices
- Turn the MacBook upside down (screen facing down) so liquid drains away from the keyboard
- Blot visible liquid with a clean cloth or paper towel — press gently, don't rub
- Let it air-dry at room temperature for 48–72 hours (do not use a hair dryer or the rice-in-a-bag method)
- After drying, power on to test. If problems persist, take it to an Apple Store or authorized service provider
Coffee and sugary drinks leave residue after drying that continues to corrode the board. Repairs tend to cost more than for plain water spills. If you have AppleCare+, accidental damage coverage applies (a service fee is charged), so check your coverage status before bringing it in.
Keyboard Backlight Issues
"The backlight won't turn on" or "it won't turn off" is a separate issue from the keyboard not working, though both can occur at the same time.
- Backlight brightness can be adjusted manually with F5 (decrease brightness) / F6 (increase brightness) — on Touch Bar models, use the Touch Bar
- If System Settings → Keyboard → "Adjust keyboard brightness in low light" is enabled, the backlight turns off automatically in bright environments
- If the backlight is completely dark but key input is normal, an SMC reset (Intel Mac only) or a restart may fix it
macOS Recovery / Reinstall
If none of the steps above helped, it's time to boot into macOS Recovery and repair the OS at the system level. The procedure for entering Recovery is also different for Apple Silicon and Intel Mac.
Apple Silicon: How to Boot into Recovery
- Fully shut down your Mac
- Hold the power button until "Loading startup options…" appears
- In the startup options screen, click "Options" (the gear icon) → "Continue"
- Enter an administrator password to launch the macOS Recovery environment
Intel Mac: Boot into Recovery with Cmd + R
- Shut down or restart your Mac
- Immediately after pressing the power button, hold Cmd + R
- Release the keys once the Apple logo appears and wait for the Recovery environment to load
If the keyboard is completely dead and you can't hold Cmd + R in time, try Internet Recovery (Cmd + Option + R) instead — or plug in an external USB keyboard and try again. Timing is critical; press the keys as soon as the power button is pressed.
Reinstalling macOS (Data Preserved)
- From the Recovery menu, launch "Disk Utility", select your startup disk (Macintosh HD), and run "First Aid"
- If First Aid reports errors, run it again after repairing until no errors remain
- Return to the Recovery menu and select "Reinstall macOS"
- Choose Macintosh HD as the destination and wait for installation to complete (30–60 minutes)
"Reinstall macOS" overwrites only the macOS system files while preserving your user data, apps, and settings. It's still a good idea to take a Time Machine backup beforehand.
If Nothing Works: Deciding on Repair
If you've worked through all the steps above and nothing has helped, a hardware failure is essentially confirmed.
Replacing the Magic Keyboard
Individual component repair is not practical for the Magic Keyboard — Apple's repair service typically replaces the whole unit.
- With AppleCare+: You may be able to request a repair or replacement for the Magic Keyboard as an accessory to your Mac through Apple Support
- Without AppleCare+ or out of warranty: Paid replacement at an Apple Store, or switching to a third-party Bluetooth or USB-C keyboard, is the most realistic option
- There are many alternatives to choose from; popular options include the Logitech MX Keys, HHKB, and Topre REALFORCE for Mac
Repairing the Built-in Keyboard and Visiting an Apple Store
Repairing the built-in MacBook keyboard requires a visit to an Apple Store Genius Bar or an Apple Authorized Service Provider.
- Cost estimates: Built-in keyboard replacement usually means replacing the entire top case (the palm rest assembly), which typically runs roughly $300–$800 depending on the model
- Before bringing it in, run Apple Diagnostics for an official diagnostic report — this can speed up the service process (Apple Silicon: hold power → startup options → Cmd + D; Intel Mac: hold D immediately after powering on)
- If you have a butterfly-keyboard MacBook Pro (2016–2019) with a specific key that keeps sticking, check with Apple Support whether it qualifies for the "MacBook Keyboard Service Program"
- Connecting an external keyboard via USB-C lets you keep working even if the built-in keyboard is broken
Keyboard issues aren't exclusive to Mac. For Windows users, see How to Fix a Keyboard Not Working on Windows | USB, Bluetooth, and Laptop Diagnosis for a similar walkthrough.
Summary: Troubleshooting Order Checklist
Recommended order of steps when your Mac keyboard isn't working.
- Identify your symptom (built-in / external / some keys only / only while typing / only after login)
- Enable the Accessibility Keyboard so you can operate the Mac even without a working keyboard
- For external keyboards: check battery / power switch / re-pair / try a different port
- Try a restart (the simplest and most effective fix)
- Intel Mac only: try an SMC reset
- Intel Mac only: try an NVRAM reset (Cmd + Option + P + R)
- Check System Settings → Accessibility → Keyboard to confirm Slow Keys and Mouse Keys are off
- Check System Settings → Keyboard for input sources and modifier key settings
- If the keyboard freezes only while typing: restart the IME process via Activity Monitor
- Boot into Safe Mode to see whether the problem reproduces
- If Safe Mode fixes it: disable login items and Karabiner-Elements to pinpoint the cause
- For the MacBook built-in keyboard: blow out dust with compressed air; if liquid was spilled, power off immediately and let it air-dry
- From macOS Recovery, run First Aid → reinstall macOS
- If nothing helps: visit a Genius Bar or Apple Authorized Service Provider
Most cases are resolved by steps 1–4. Accurately identifying your symptom up front lets you skip irrelevant steps and get back up and running as quickly as possible. For Mac problems in general, see the Mac Troubleshooting Guide | Fixes Organized by Symptom as well.
