Back to Blog
Troubleshooting 19 June 2026 9 min read

MacBook Keyboard Keys Not Working: A Complete Repair Guide from Our Hyde Park Workshop

Your MacBook keyboard is failing you at the worst possible moment. A key that won't respond. Another that sticks. Maybe several have stopped working altogether. If you're based in Johannesburg or anyw.

Over the past six years, we've repaired more than 18,000 MacBooks with keyboard faults in our Hyde Park workshop. The patterns are clear, the solutions are proven, and in most cases, we can have your keyboard functioning again within days. This guide covers everything we've learned from those thousands of repairs: what causes MacBook keyboards to fail, why your model matters, and what your repair options actually are.

Why MacBook Keyboards Fail: The Hardware Reality

Apple's keyboard engineering has been contentious for a decade. The butterfly mechanism, introduced in 2015 and used through to 2019, was notoriously prone to failure. We've seen it countless times: a single speck of dust, a fragment of food, even normal wear particles accumulate beneath the shallow key cap and jam the switch mechanism. The Keys simply refuse to register.

In our workshop, we've documented the progression clearly. The 2015-2017 models suffered the most failures. By 2018-2019, Apple acknowledged the faults and introduced the revised butterfly mechanism, marginally better, but still fragile. From 2021 onwards, the return to scissor-switch keyboards (similar to older pre-2015 models) has proven far more reliable.

What causes keys to stop working? The culprits we encounter most often:

Dust and debris infiltration. The butterfly mechanism's shallow travel distance leaves minimal clearance. In Johannesburg's dusty climate, this is particularly problematic. We've opened MacBooks and found visible particles blocking key switches.

Liquid exposure. Tea. Coffee. Spilled water. Even load shedding-related condensation can seep into the keyboard matrix. Liquid damage often doesn't kill a key instantly, it corrodes the electrical contacts gradually. We recommend immediate assessment if you've spilled anything on your keyboard; waiting can turn a R599 assessment into a full board replacement.

Manufacturing defects. Some butterfly switches were simply faulty out of the box. Apple's keyboard recall programme (2018-2020) addressed this for certain models, but many users never pursued the free repair.

Physical wear. Repeated key presses, especially on high-use keys like the spacebar or common letters, wear the switch mechanism over time. The contact points degrade, and eventually, the key stops responding reliably.

Butterfly vs. Scissor Switches: Which MacBooks Have Which?

Understanding your keyboard type is essential, because repair approaches differ significantly.

Butterfly switches were fitted to MacBook Air (2018-2019), MacBook Pro (2016-2019), and the 12-inch MacBook (2015-2017). If your MacBook is from this era and a key stops working, the entire butterfly switch mechanism typically requires replacement. We rarely repair individual butterfly switches; the engineering is too delicate. Our assessment (R599) identifies the exact switches at fault, and we source OEM-grade replacements. Most butterfly keyboard repairs run R1,200-R2,400, depending on how many keys need replacing and whether the keyboard layer itself is damaged.

Scissor switches are fitted to all MacBooks from 2021 onwards, and they're markedly more robust. Individual key cap replacements often work. If a scissor-switch key fails, we can sometimes replace just the cap and mechanism without removing the entire keyboard. This keeps costs lower, typically R400-R800 per key.

If you're unsure which keyboard your MacBook has, check the model identifier. Open Apple menu โ†’ About This Mac, and note the model year. Our team can also identify it during a free visual inspection when you visit our Hyde Park location.

Common MacBook Keyboard Problems We See Every Week

In our workshop, certain issues repeat constantly.

Keys that register double characters. You press 'e' once and get 'ee'. This usually signals electrical contact bounce, the switch mechanism is closing and opening rapidly. It's often fixable with careful cleaning, though sometimes requires a key replacement.

Sticky keys that require harder pressure. The key physically sticks down and requires you to press harder or manually pull it back up. Dust and debris are the prime cause. We've successfully cleaned dozens of stuck keys using compressed air and careful disassembly.

Keys that don't register at all. Complete failure to register any keystroke. This points to a dead switch. Replacement is usually necessary. For butterfly models, this means replacing the individual switch. For scissor models, often just the key mechanism.

Intermittent key failures. The key works sometimes, fails other times, maddening and unpredictable. This is classic corrosion or early liquid damage. If not addressed, it progresses to total failure.

Keyboard chatter or ghost keystrokes. Characters appear without you pressing any key, or single presses produce multiple characters. This is a board-level electrical fault, often related to liquid damage or a failing keyboard ribbon cable. Our liquid damage repair service can often recover the keyboard matrix, though sometimes a full keyboard replacement is the most cost-effective option.

What to Do Right Now: Immediate Steps

If your keyboard is failing, here's what we recommend:

First, isolate the problem. Is it a single key or multiple keys? Is the issue consistent or intermittent? Open Notes or TextEdit and test each key methodically. Note which keys fail. Take a photo or write down the specific characters that aren't working. This information helps us diagnose faster during your assessment.

Check for liquid exposure. Have you spilled anything? Are there visible marks, discolouration, or corrosion around the keyboard? Even if you haven't spilled anything recently, moisture from load shedding conditions here in Johannesburg can be the culprit. Tell us about humidity exposure when you contact us.

Avoid temporary workarounds that cause permanent damage. Using an external keyboard is fine temporarily, but don't attempt to pry up key caps or blow compressed air forcefully into the keyboard yourself. We've seen customers inadvertently jam debris deeper or crack ribbon cables. Let our technicians handle that.

Book an assessment immediately. Our R599 full diagnostic assessment identifies the exact fault, the repair cost, and whether your MacBook qualifies for any warranty coverage or Apple recall programmes. We can often complete the assessment on the same day you visit our Hyde Park workshop. Book online at zasupport.com/book, or WhatsApp us on 064 529 5863 to check availability.

Repair Solutions: From Cleaning to Full Replacement

Our approach is always pragmatic. We repair what's economical to repair; we replace what isn't.

Compressed air and cleaning. For sticky keys caused by dust, we use precision compressed air and specialist cleaning solutions. This costs around R200-R300 and succeeds roughly 60% of the time for stuck-key problems. It's always worth attempting before moving to replacement.

Individual key or switch replacement. For butterfly models, we can replace a single failed switch without replacing the entire keyboard. For scissor models, it's even simpler, we replace just the key cap and switch mechanism. Costs run R400-R800 per key, depending on the model.

Full keyboard replacement. When multiple keys fail or when the keyboard ribbon cable or matrix is compromised, full replacement is often the most cost-effective path. We source OEM-grade keyboards (not cheap third-party variants) and fit them professionally. Costs range from R1,400 to R3,200, depending on your MacBook model and whether labour is required to remove the battery or other components.

Logic board repair for liquid damage. If liquid damage has affected the keyboard's electrical matrix, we can often repair the logic board without full keyboard replacement. This is more complex and expensive (typically R1,800-R3,500), but preserves the original keyboard hardware.

All our keyboard repairs come with a 3-year warranty on parts and labour, so you're protected if a replacement key or keyboard fails within that timeframe.

Why Choose Professional Repair Over DIY or Mail-In Services

We understand the temptation. Keyboard repair videos are everywhere on YouTube. Mail-in services promise convenience. Neither is ideal for most users.

DIY repair risks ribbon cable damage, cross-threading of microscopic screws, and accidental liquid spills during disassembly. We've seen MacBooks with functioning keyboards destroyed by a slip during attempted self-repair.

Mail-in services take weeks. In Johannesburg, where you might be without a laptop during load shedding hours, a week without your MacBook is lost productivity. Our Hyde Park workshop turnaround is typically 2-5 working days, and we keep you updated throughout.

Professional repair means OEM-grade parts, precision tools, and technicians who've handled more than 18,000 MacBook repairs. We know the failure patterns. We know which components are worth replacing and which are just symptoms. We stand behind our work with warranty coverage.

Frequently Asked Questions

Q: How do I know if my keyboard problem is covered by Apple's recall programme?

Apple issued free keyboard repairs for certain MacBook Air, MacBook Pro, and 12-inch MacBook models manufactured between 2015 and 2019. The recall covers butterfly-switch keyboards with unresponsive or sticky keys. Check your serial number on Apple's official repair extension programme page, or bring your MacBook to us for a free serial check. If your model is covered, we can arrange the Apple repair; if not, we provide independent repair at competitive rates.

Q: Can I use an external keyboard permanently while I arrange the repair?

Absolutely. A USB or Bluetooth keyboard is a practical workaround, and many users keep one as backup anyway. However, the built-in keyboard is still valuable, for portability, resale value, and those moments when you're away from your desk. We recommend getting it repaired rather than leaving it broken indefinitely.

Q: What's the difference between cleaning and replacing a keyboard?

Cleaning (compressed air and specialist solutions) is quick, low-cost (R200-R300), and works for dust-related sticking. Replacement (R1,400-R3,200) is necessary when switches are electrically dead, the ribbon cable is damaged, or multiple keys have failed. We diagnose which approach is right for your MacBook during the R599 assessment.

Q: How long do keyboard repairs take?

Most single-key replacements take 1-2 days. Full keyboard replacements take 3-5 working days, depending on whether we're sourcing a keyboard or performing additional diagnostics. Liquid damage repairs can take longer if board-level repair is required. We provide a time estimate during your assessment.

Q: Is it worth repairing a keyboard on a five-year-old MacBook, or should I buy a new one?

For most MacBooks, keyboard repair makes financial sense. A R2,000 repair keeps a laptop worth R8,000-R12,000 in working condition. The exception is if your MacBook has other significant faults (battery failure, screen damage, logic board issues) that total more than the laptop's current value. We're honest about this during assessment. If repair doesn't make sense, we'll tell you.

Q: What happens if a replaced key fails again within the warranty period?

Our 3-year warranty covers parts and labour. If a key we've replaced fails within three years, you get a free replacement, no questions, no additional cost. We've built this warranty because we're confident in our repairs and our parts sourcing. Bring your MacBook back, and we'll fix it immediately.

---

Keyboard failures are frustrating, but they're almost never permanent. We've brought more than 18,000 MacBooks back to full keyboard function. Your MacBook can be one of them. Book online at zasupport.com/book for your R599 assessment, or WhatsApp us on 064 529 5863 to discuss your specific issue. We're in Hyde Park, Johannesburg, and ready to help.

Courtney Bentley, CEO & Apple Certified Expert Consultant at ZA Support

Written by

Courtney Bentley

CEO & Apple Certified Expert Consultant

Former Apple South Africa Manager (2007-2009). Founded ZA Support at age 19 in 2009. Forbes Africa 30 Under 30 (2019). Co-founder of Vizibiliti Insight Africa (2016). Has overseen ZA Support's 25,000+ Mac repair operations at the Hyde Park workshop. Specialises in component-level logic board repair, liquid damage recovery, and medical practice IT. UNISA Artificial Intelligence / Cognitive Computing (2017-ongoing). Member of the Apple Developer Program.

View all articles by Courtney โ†’

Need a repair? Assessment from R599.

Hyde Park, Johannesburg. Same-day diagnostics available.