MacBook keyboard not working, with a close-up of the built-in keyboard and a typing problem displayed on the laptop screen.
|

MacBook Keyboard Not Working? Find the Cause

When your MacBook keyboard stops working, you may find that certain keys no longer respond, typing produces the wrong characters, or the entire keyboard becomes unresponsive. Sometimes the problem appears suddenly. In other cases, it starts after a macOS update, a settings change, or a liquid spill.

The first step is to determine whether the issue affects individual keys, the built-in keyboard, or typing across macOS. A software setting can make a working keyboard seem faulty, while physical damage may require professional repair.

Before buying an external keyboard or arranging a repair, work through these checks to narrow down the cause.

Quick Diagnosis: Start Here

Copy this HTML into the WordPress Code editor, then switch to the Visual editor. The links use explicit destinations matching the Fix numbers below.

Quick Diagnosis: Start Here

What you’re seeingStart here
None of the built-in keyboard keys respondGo to Fix 1 ↗
Only certain keys are not workingGo to Fix 2 ↗
Keys type the wrong characters or repeat unexpectedlyGo to Fix 3 ↗
The keyboard works intermittentlyGo to Fix 4 ↗
Keyboard shortcuts or special keys are not workingGo to Fix 5 ↗
The keyboard stopped working after a macOS updateGo to Fix 6 ↗
The keyboard fails in specific apps or login screensGo to Fix 7 ↗
The keyboard remains unresponsive after basic checksGo to Fix 8 ↗

Fix 1: Check Whether the Entire Keyboard Is Unresponsive

If none of the keys work, first determine whether the issue is limited to the built-in keyboard or affects typing more broadly.

Try these checks:

  1. Click a text field in an app you know is working, such as Notes or a browser’s address bar.
  2. Press a few different letter keys and check whether anything appears.
  3. If your MacBook has a Touch ID or power button separate from the main keyboard area, check whether it responds normally.
  4. Connect a compatible external keyboard, if available, and test typing.

If the external keyboard works but the built-in keyboard does not, the problem may involve the built-in keyboard, its connection, or a setting affecting its operation.

If neither keyboard works, investigate whether macOS is frozen or whether the problem affects a particular app or login screen.

If the MacBook itself is unresponsive, save any work you can and restart it when safe to do so. Avoid forcing a shutdown while an update is visibly in progress.

Fix 2: Check Individual Keys and Physical Obstructions

When only certain keys fail, the cause may be localised to those keys rather than the entire keyboard.

Start by testing several keys in different areas. Open Notes or another text field and check whether the same keys fail consistently.

Look for:

  • Visible debris around the affected keys
  • Keys that feel stuck or do not move normally
  • Signs of liquid exposure
  • Damage caused by impact or pressure

If the keyboard is dry and there is loose surface dust, turn off the MacBook and follow Apple’s cleaning guidance for your specific model. Do not pour liquid into the keyboard, use sharp objects to lift keycaps, or force a stuck key.

If the same keys continue to fail, particularly after a spill or physical impact, the problem may be hardware-related. MacBook keyboard mechanisms vary by model, so avoid removing keycaps unless the manufacturer specifically supports that procedure.

A single non-responsive key can be a useful clue. If the same key fails consistently across different applications, a physical keyboard problem becomes more likely.

Fix 3: Correct Unexpected Characters or Repeating Keys

If the keyboard works but produces unexpected characters, the issue may involve the selected input source, keyboard settings, or a key that is registering repeatedly.

Check the keyboard input source

If pressing a key produces a different character than expected, review the selected keyboard layout.

  1. Open System Settings.
  2. Select Keyboard.
  3. Find the text input or input source settings available on your macOS version.
  4. Confirm that the intended language and keyboard layout are selected.

Different layouts can assign different characters to the same physical keys. This can happen after adding another language or changing input settings.

Check for repeating or stuck keys

If a character appears repeatedly without repeated key presses, check whether a key is physically stuck. Also review the key repeat settings in Keyboard settings.

You can temporarily adjust the key repeat rate to see whether the behaviour changes. If a key continues repeating even when you are not touching it, the cause may be physical rather than a typing preference.

If only one application displays the wrong characters, test another app before changing system-wide settings.

Fix 4: Troubleshoot an Intermittent Keyboard

If your MacBook keyboard works sometimes but stops responding at other times, look for a repeatable pattern.

For example, does it stop working after the MacBook wakes from sleep? Does the issue occur only when the computer is warm? Or do particular keys become unreliable regardless of the application?

Try the following:

  1. Save your work.
  2. Restart your MacBook if it is safe to do so.
  3. Test the keyboard in more than one application.
  4. Disconnect unnecessary external devices and accessories.
  5. Observe whether the issue returns after waking the MacBook from sleep.

If the keyboard consistently fails after waking from sleep but works after a restart, a software or system-level issue may be involved.

If the same keys repeatedly stop responding, or the problem began after physical damage or liquid exposure, arrange a hardware inspection.

Avoid repeatedly pressing or flexing the affected keys to make them work. That can worsen an existing physical fault.

Fix 5: Review Accessibility and Keyboard Settings

macOS includes accessibility features that change how keyboard input behaves. Some settings can make it seem as though certain keys are not working normally.

Open System Settings → Accessibility → Keyboard and review the available options.

Pay particular attention to:

  • Slow Keys: This feature can require a key to be held for a longer period before the keystroke is accepted.
  • Sticky Keys: This changes how modifier keys such as Command, Option, Control, and Shift work together.
  • Full Keyboard Access: This changes how the keyboard navigates controls and elements in supported interfaces.

The exact menu names and available options may vary by macOS version.

If you do not intentionally use these features, check whether any have been enabled accidentally. Change one setting at a time and test the keyboard again.

If the problem involves only keyboard shortcuts, also check whether an app has custom shortcuts or whether a modifier key is stuck.

Do not disable accessibility features that you rely on. The aim is to identify whether a setting explains the behaviour, not to turn off useful functionality unnecessarily.

Fix 6: Investigate Problems That Started After a macOS Update

If the keyboard stopped working shortly after a macOS update, first check whether the update completed successfully.

An update may temporarily involve background activity, and an interrupted or incomplete process can sometimes cause unexpected behaviour.

Try these steps:

  1. Restart your MacBook if no update is in progress.
  2. Test the keyboard in multiple applications.
  3. Check System Settings → General → Software Update for any available follow-up updates.
  4. If an external keyboard works, use it to complete basic checks while investigating the built-in keyboard.
  5. Review whether the issue began immediately after the update or appeared later.

If the keyboard works in some places but not others, a system-wide hardware failure is less likely to be the only explanation.

Avoid reinstalling macOS as an initial troubleshooting step. Back up important data before attempting major system repairs, and seek assistance if the keyboard problem prevents you from safely accessing your Mac.

Fix 7: Determine Whether the Problem Is Limited to an App or Login Screen

A keyboard that works in one place but not another can point to an application-specific issue, a login problem, or a system setting.

Start by testing the keyboard in several contexts:

  • Type in Notes or another simple text editor.
  • Try typing in a browser address bar.
  • Test the keyboard in another application that accepts text.
  • If you can access the desktop, check whether the issue occurs only in one app.

If typing works everywhere except one application, update that app and review its settings. Some apps use keyboard shortcuts or input controls that differ from ordinary text fields.

If the keyboard does not work at the login screen, an external keyboard may help you determine whether the issue is limited to the built-in keyboard. However, if FileVault or another security feature is involved, available input options may vary.

If the keyboard works in macOS Recovery or another startup environment but not during normal use, that can help narrow the issue to software or configuration. It does not, by itself, rule out every hardware fault.

If you cannot sign in or access the tools needed to investigate, seek help through Apple Support rather than repeatedly changing startup settings.

Fix 8: Arrange Further Diagnosis if the Keyboard Still Fails

If none of the earlier checks resolves the problem, the keyboard may need professional assessment.

This is particularly important if:

  • Several keys have stopped responding permanently.
  • The keyboard became unreliable after liquid exposure.
  • Keys feel physically stuck or damaged.
  • The problem persists across multiple applications and after restarting.
  • An external keyboard works reliably while the built-in keyboard does not.

Before arranging service, back up your important files if you can access the MacBook safely.

You can also check whether your MacBook supports Apple Diagnostics and run it according to Apple’s instructions for your model. A diagnostic result may identify certain hardware problems, although a normal result does not rule out every keyboard fault.

Do not open the MacBook or attempt to disconnect internal keyboard components unless you are qualified to do so. Internal components are compact, and repair procedures vary by model.

If liquid has entered the keyboard, turn off the MacBook, disconnect power if safe, and seek professional advice promptly. Do not continue testing the keyboard or apply heat in an attempt to dry it.

Why a MacBook Keyboard Stops Working

Keyboard problems generally fall into a few categories:

  • Physical obstruction or damage: Debris, stuck keys, wear, or liquid exposure may prevent individual keys from registering.
  • Keyboard settings: Input sources, key repeat preferences, or accessibility features can change how keystrokes behave.
  • Application problems: A particular app may fail to accept input or may use custom keyboard shortcuts.
  • Software issues: A temporary macOS problem or a change following an update may affect keyboard behaviour.
  • Hardware faults: A damaged built-in keyboard or internal connection may cause persistent or intermittent failures.

The pattern of the failure is important. One key failing consistently is different from the entire keyboard becoming unresponsive after waking from sleep. Identifying that pattern helps you choose the appropriate next step.

How to Prevent MacBook Keyboard Problems

You cannot prevent every keyboard fault, but these habits can reduce avoidable problems.

  • Keep liquids away: Even small spills can damage the keyboard and internal components.
  • Clean carefully: Follow the cleaning guidance for your specific MacBook model instead of using liquids or sharp tools around the keys.
  • Avoid pressure on the keyboard: Do not place heavy objects on a closed MacBook or force stuck keys.
  • Keep macOS and apps updated: Appropriate updates can address software-related input problems.
  • Review settings before changing hardware: Check input sources and accessibility features before assuming the keyboard is broken.
  • Back up your files: Maintain a reliable backup so that hardware or system problems do not put important data at risk.
  • Investigate recurring failures early: Repeatedly unresponsive keys deserve attention before the problem becomes more extensive.

Frequently Asked Questions

Why is my MacBook keyboard not working but the trackpad is?

The trackpad and keyboard use different input mechanisms, so one can work while the other fails. Check keyboard settings, test typing in different applications, and connect an external keyboard if possible. If the built-in keyboard remains unresponsive, hardware diagnosis may be necessary.

Why are only some keys on my MacBook not working?

Individual keys may be affected by debris, physical wear, liquid exposure, or a hardware fault. Test the same keys in different applications. If they consistently fail, avoid forcing or removing the keycaps and seek repair advice.

Can a macOS update cause keyboard problems?

Keyboard issues can appear after an update because of software or configuration changes, although the timing alone does not prove that the update caused the problem. Restart the MacBook if safe, check for follow-up updates, and test the keyboard across several applications.

How do I reset my MacBook keyboard?

There is no universal keyboard reset procedure for every MacBook. Start by checking the keyboard layout, accessibility settings, and key repeat preferences. Restarting may resolve a temporary software issue. Avoid using model-specific reset instructions unless they apply to your Mac.

Can I use an external keyboard if my MacBook keyboard is broken?

Yes. A compatible USB or Bluetooth keyboard can provide a temporary way to type. If using Bluetooth, you may need to connect or pair it before you can use it. An external keyboard can also help determine whether the issue is limited to the built-in keyboard.

Should I replace my MacBook keyboard if a few keys have stopped working?

Not immediately. First check for settings issues, test the keys in multiple applications, and inspect for visible obstructions. If the same keys remain unresponsive, particularly after a spill or physical damage, have the keyboard assessed before deciding on a repair.

Found this helpful? Share it.

Related Troubleshooting