Hardware test
Mac Keyboard Tester
Click the MacBook keyboard below and press every key. Each one turns green once it has worked. A few keys never reach a web page on a Mac (fn and Touch ID), and the function row needs one setting changed first, explained under the tester.
Updated · Runs in your browser, nothing is uploaded
Click here, then press every key
Mac keys that need a little help
| Key | What happens |
|---|---|
| F1 to F12 | By default they change brightness, volume and so on, and macOS handles them before the browser sees them. Hold fn while you press them, or turn on System Settings › Keyboard › Keyboard Shortcuts › Function Keys › "Use F1, F2, etc. keys as standard function keys". |
| fn / globe | Never reaches web pages. It is drawn with a dashed outline and isn't counted. |
| Touch ID | Same: macOS keeps it. Test it by unlocking the Mac. |
| Caps lock | macOS ignores a very short tap to avoid accidental caps. Press it a little longer. The tester logs it as on or off. |
| Command shortcuts | Command+Q, Command+W and Command+Tab act before the page can stop them. Press Command on its own; in Chrome, the full screen button catches most combinations. |
Keys that repeat, stick or skip
Watch the log while you type a few lines. A letter that appears twice within a few milliseconds is marked in red; that's the key bouncing, not you. A key that sometimes doesn't light up at all is the opposite problem. Both usually come from dust or crumbs under the key, and on the 2015–2019 MacBooks with butterfly keyboards they were common enough that Apple ran a repair program. It covered each Mac for four years from its first retail sale, so those Macs are now outside it, but an Apple Store or authorized service provider can still quote a repair.
Before a repair, try Apple's own cleaning method: hold the Mac at a 75° angle and spray compressed air across the keyboard from left to right, then repeat with the Mac turned on its right side and on its left side.
Questions
Can I test a Magic Keyboard or another external keyboard?
Yes. Pick "Windows / PC (full size)" for a keyboard with a number pad; the keys are in the same places, and Option and Command light up as Alt and Win.
Why did a key stay highlighted after I released Command?
macOS doesn't report releasing a key while Command is held. The tester clears held keys when Command goes up, so press the key again if it looks stuck.
Is it safe to type a password here?
Nothing you type is stored or sent, but there's no reason to: any key tests the same way.