0480 080 288 Mon–Sat · Same Day Service
All Melbourne Suburbs No Fix No Fee

MacBook Guide

MacBook Keyboard Not Working? How to Fix It

A MacBook keyboard not working can be anything from a single sticky key to a keyboard that ignores every press. The good news is that many cases are caused by a macOS setting, a crumb under a key or a system glitch that a restart clears. This guide covers MacBook Air and MacBook Pro models, including the butterfly keyboards from 2016 to 2019, and explains when the keyboard needs a repair.

  • MacBook Air and Pro
  • Intel and Apple Silicon
  • Butterfly Keyboards Covered
  • Files Left Untouched

Is It One Key, Several Keys or the Whole Keyboard?

Start by working out how much of the keyboard is affected. A single key that sticks, repeats or does nothing is usually debris or a worn switch. However, if several keys in one area fail together, a spill or a damaged keyboard is more likely.

If the whole keyboard has stopped, connect a USB or Bluetooth keyboard. If that works, macOS is fine and the built in keyboard is the problem. In addition, an external keyboard lets you sign in while you troubleshoot.

Also check the trackpad. On many MacBooks the keyboard and trackpad share the same connection. Therefore, if both stop at once, a cable or board fault becomes more likely than a keyboard setting.

Keys Repeating or Doubling

Typing two letters for one press is a classic butterfly keyboard symptom, often caused by dust under the key.

Keys Need a Long Press

If keys only respond when held, Slow Keys is probably switched on in Accessibility settings.

What to Look For

  • One key stuck. Debris or worn switch.

  • Letters doubling. Typical butterfly keyboard fault.

  • Keyboard and trackpad dead. Cable or board issue.

  • Keys slow to respond. Slow Keys switched on.

What Are the First Fixes for a MacBook Keyboard?

These quick checks fix many MacBook keyboard problems without any tools.

  1. Restart the MacBook

    Choose Restart from the Apple menu. This reloads the keyboard driver and clears many temporary faults.

  2. Turn Off Slow Keys and Mouse Keys

    Open System Settings, then Accessibility, then Keyboard, and switch off Slow Keys. Then check Pointer Control and switch off Mouse Keys, which can take over some keys.

  3. Check the Input Source

    Open System Settings, then Keyboard, then Input Sources. Make sure the right layout is selected, because the wrong one moves symbols around.

  4. Clean Under the Keys

    Hold the MacBook at a 75 degree angle and spray compressed air across the keys in a left to right motion, as Apple recommends. Then rotate it and repeat from each side.

Which Resets Help a MacBook Keyboard That Stopped?

If the quick checks have not worked, these resets clear deeper glitches. They do not touch your files.

Start in Safe Mode

On Apple silicon, shut down, hold the power button until the options appear, select your disk, then hold Shift and click Continue in Safe Mode. On Intel, hold Shift while starting. If the keyboard works in Safe Mode, a third party app or login item is the cause.

Reset the SMC on Intel Models

On Intel MacBooks with the T2 chip, shut down, then hold Control, Option and Shift for seven seconds, add the power button and hold all four for another seven seconds. Apple silicon models do not need this, because a restart does the same job.

Reset NVRAM on Intel Models

Shut down, then turn on and immediately hold Option, Command, P and R for about 20 seconds. This resets some keyboard and display settings.

Useful Mac Keys

Shift at startup

Safe Mode on Intel Macs.

D at startup

Apple Diagnostics on Intel Macs.

Command and D

Apple Diagnostics from the startup options on Apple silicon.

Keyboard Viewer

Shows which keys macOS can detect.

Why Is My MacBook Keyboard Not Working?

These are the causes we find most often in MacBook Air and MacBook Pro keyboards.

Debris Under the Keys

Crumbs and dust stop keys travelling properly. In fact, this is the main reason butterfly keys stick or repeat.

Accessibility Settings

Slow Keys or Mouse Keys has been switched on, so keys seem slow or stop typing letters.

Software Conflict

A third party keyboard app or a stuck macOS process stops input. Safe Mode helps confirm this.

Swollen Battery

An ageing battery can swell under the keyboard, pushing keys up and making them stiff. This needs prompt attention.

Failed Keyboard or Cable

Worn switches, a damaged flex cable or a board fault need a repair rather than a setting change.

Which macOS Settings Affect the Keyboard?

Several macOS settings can make a working keyboard seem faulty, so check them before assuming the worst.

Key Repeat and Delay

In Keyboard settings, a very short delay makes keys seem to repeat. Move the slider towards Long and test again.

Modifier Keys

Keyboard Shortcuts, then Modifier Keys, can swap keys such as Command and Control. Restore the defaults if keys behave oddly.

Function Keys

Choose whether the top row controls brightness and volume or acts as F1 to F12. Changing this can make keys seem broken.

Things to Avoid

  • Prying off keycaps. Butterfly caps break very easily.

  • Spraying liquid cleaner. It can run under the keys.

  • Using a raised keyboard. It may be a swollen battery.

  • Charging after a spill. Switch off and get it checked.

Which MacBooks Have the Butterfly Keyboard?

Apple used a very thin butterfly keyboard on the 12 inch MacBook from 2015, the MacBook Pro from 2016 to 2019 and the MacBook Air from 2018 to 2019. These keyboards are slim, but a single piece of dust can stop a key working or make it type twice.

Apple ran a keyboard service programme for these models, covering them for four years after the first retail sale. As a result, most of these MacBooks are now outside that programme. Even so, a repair is still worthwhile for many owners, because the rest of the laptop often works perfectly.

From the 16 inch MacBook Pro in late 2019, and across the range in 2020, Apple moved to the Magic Keyboard with scissor switches. These are far more reliable, so a fault on a newer MacBook is more likely to be liquid, wear or a cable.

How Do You Test a MacBook Keyboard?

macOS includes a Keyboard Viewer that shows each key light up as you press it. Turn it on in System Settings, then Keyboard, then Input Sources, by ticking Show Input menu in menu bar. Then choose Show Keyboard Viewer from the menu bar icon and press each key in turn.

Apple Diagnostics goes deeper and runs outside macOS. On Apple silicon, shut down, hold the power button until the startup options appear, then press Command and D. On Intel models, hold D while the MacBook starts. The test reports a reference code if it finds a hardware problem.

If the keyboard fails in both tests, it needs repair. On the other hand, if it passes, go back to the settings and Safe Mode steps, because the cause is software.

Can a MacBook Keyboard Be Replaced on Its Own?

On most MacBook Air and MacBook Pro models, the keyboard is riveted into the top case along with the battery. Therefore, replacing it is a bigger job than on many Windows laptops, and the battery is often replaced at the same time.

However, a single key can sometimes be repaired on its own. If one key is broken but the rest work well, ask about replacing just that key and its switch, which costs much less.

Is It Worth Repairing?

Usually yes, if the rest of the MacBook is in good condition. See our MacBook repair versus Apple Store guide to compare options.

What If You Cannot Type Your MacBook Password?

If the keyboard stops at the login screen, connect a USB or Bluetooth keyboard and sign in with that. In addition, macOS can show an on screen keyboard at login if the Accessibility Keyboard was turned on beforehand.

Once you are signed in, go through the settings and Safe Mode steps above. If the built in keyboard works in Safe Mode, remove recently installed keyboard or text expansion apps, because they are a common cause.

How Do You Look After a MacBook Keyboard?

A few simple habits prevent most keyboard problems.

Keep Food and Drinks Away

Crumbs and spills cause most of the keyboard faults we see on MacBooks.

Clean Every Few Months

Use Apple’s compressed air method regularly, rather than waiting for a key to stick.

Close the Lid When Not in Use

This keeps dust out of the keys, especially in a busy household.

Watch Battery Health

Check battery health in System Settings. A worn battery should be replaced before it swells under the keyboard.

When Should a MacBook Keyboard Go for Repair?

If cleaning and the resets have not helped, or Apple Diagnostics reports a fault, the keyboard, its cable or the board needs attention. Equally, any keyboard that has become raised or stiff needs checking straight away because of the battery risk.

Our MacBook repair Melbourne service tests the keyboard, battery and board and gives you a quote before any work starts. For general keyboard problems, see our laptop keyboard repair page.

What to Share

  • Model and year. From About This Mac.

  • Which keys fail. One, several or all.

  • Any spill. And how long ago.

MacBook Keyboard Questions Answered

Quick answers for MacBook Air and MacBook Pro owners.

Why are some keys on my MacBook not working?

Debris under the keys is the most common cause, especially on butterfly keyboards. Clean with compressed air at a 75 degree angle, then restart.

Why does my MacBook keyboard type double letters?

This is a known butterfly keyboard fault caused by dust. Cleaning sometimes helps, but a worn switch may need replacing.

How do I reset my MacBook keyboard?

Restart first. On Intel models, reset the SMC and NVRAM. On Apple silicon, a full shutdown and restart does the same job.

Why is my MacBook keyboard and trackpad not working?

When both fail together, a cable, liquid damage or a board fault is likely. Try Safe Mode and Apple Diagnostics, then get it checked.

Is the Apple keyboard service programme still running?

The programme covered butterfly keyboards for four years after sale, so most affected models are now outside it.

How long does a MacBook keyboard repair take?

It depends on the model and whether parts are in stock. A single key is often quick, while a full top case takes longer.

Getting Your MacBook Keyboard Working Again

In many cases, a MacBook keyboard not working is caused by debris, an accessibility setting or a software glitch. Restart, check Slow Keys and Mouse Keys, clean with compressed air and try Safe Mode. On Intel models, reset the SMC and NVRAM too.

If the keyboard fails Apple Diagnostics, or several keys stopped after a spill, it needs repair. At that point, a technician can confirm the fault and quote the work before anything is done.

MacBook Keyboard Still Playing Up?

Call us and we will help you find out whether it is a setting, debris or the keyboard itself.