Mac Keyboard Not Working? Fixes for Common Keyboard Issues

Keyboard issues on Mac range from a single stuck key to the entire keyboard being unresponsive. Most are software-related and fixable without a trip to the Apple Store.

Quick checks

External keyboard If you're using an external keyboard: 1. **USB:** Try a different USB port. Try a different cable if detachable. Make sure USB hubs are powered. 2. **Bluetooth:** Turn Bluetooth off and on. Remove the keyboard from Bluetooth devices and re-pair it. Check battery level. 3. **Both:** Test the keyboard on another computer to rule out hardware failure.

Built-in keyboard (MacBook) If the built-in keyboard isn't working: 1. Check if an external keyboard works — this helps determine if it's hardware or software. 2. Try each key individually — partial failures suggest hardware issues (especially on butterfly keyboards).

Software fixes

Check keyboard layout A wrong keyboard layout can make it seem like keys are typing wrong characters.

System Settings > Keyboard > Input Sources. Make sure the correct language and layout are selected. Look for the input menu in the menu bar (flag icon or keyboard icon).

Disable Slow Keys If there's a delay before keys register, Slow Keys might be enabled.

System Settings > Accessibility > Keyboard > Hardware Keyboard > Disable "Slow Keys."

Check Modifier Keys settings If Cmd, Option, or Control seem swapped:

System Settings > Keyboard > Keyboard Shortcuts > Modifier Keys. Make sure each modifier is set to its default function.

Disable accent character picker If holding a key shows an accent popup instead of repeating the character: ```bash defaults write -g ApplePressAndHoldEnabled -bool false ``` Log out and back in for the change to take effect.

Adjust key repeat speed If key repeat seems too slow or doesn't work: ```bash defaults write -g KeyRepeat -int 2 defaults write -g InitialKeyRepeat -int 15 ``` Lower numbers = faster repeat and shorter delay. Log out and back in to apply.

System-level fixes

Safe Mode boot Restart and hold Shift (Intel) or hold the power button and select "Safe Mode" (Apple Silicon). Safe Mode clears caches and runs checks. If the keyboard works in Safe Mode, a third-party app or extension is the culprit.

SMC reset (Intel Macs) Shut down. Hold Shift+Control+Option+Power for 10 seconds. Release all keys. Power on.

NVRAM reset (Intel Macs) Restart. Immediately hold Option+Command+P+R for 20 seconds.

Apple Silicon Macs Simply restarting handles SMC and NVRAM equivalent resets automatically.

Hardware issues

MacBook butterfly keyboard MacBook models from 2015-2019 used butterfly keyboards prone to failure from dust and debris. Apple has a keyboard repair program for affected models. Check support.apple.com for eligibility.

Liquid damage If liquid was spilled on the keyboard, turn the Mac off immediately, flip it upside down to drain, and don't turn it on for at least 48 hours. Liquid damage often requires professional repair.

Individual key issues If only specific keys fail, the issue is likely physical. On MacBooks, keycaps can sometimes be carefully removed and cleaned. For desktop keyboards, compressed air can dislodge debris.

Keyboard settings in CleanMyMacOS

CleanMyMacOS includes keyboard tweaks for common preferences: key repeat speed, initial key repeat delay, and disabling the accent character picker. These are the same Terminal commands above, but presented as simple toggles with live state detection and one-click revert.

CleanMyMacOS can help with this — download it free from the Mac App Store.