Mac Keyboard Tester

Press every key once. A key turns green when your Mac registers it. Nothing you type leaves this page.

0 / 0 keys

F1 – F12: hold fn and press each one. Without fn, macOS uses the top row for brightness and volume and does not pass the key to the browser.

Not tested Works Held down Browsers cannot see this key

Last key: none yet

How to test a Mac keyboard

  1. Click anywhere on this page so that it has focus.
  2. Press each key once, row by row. A key shows bright green while you hold it and stays dark green after you release it.
  3. Hold fn and press F1 to F12.
  4. Read the line under the keyboard. When only a few keys are left, it lists them by name. Those are the keys to check.

The test takes about two minutes. It works with the built-in keyboard of a MacBook Air or MacBook Pro and with a Magic Keyboard connected by Bluetooth or cable.

When to use this MacBook keyboard test

  • After a spill. The keyboard is dry again and you want to know that every key still works.
  • Before you buy a used MacBook. Open this page on the seller's Mac and press every key before you pay.
  • When a letter sometimes does not appear. Press that key ten times and count how many times it lights up.
  • After a repair or a keyboard replacement. Confirm that all keys were connected again.

Keys this test cannot see

A key that stays dark is not always a broken key. macOS keeps some keys for itself and does not tell web pages about them.

KeyWhy it stays darkWhat to do
F1 – F12By default macOS uses the top row for brightness, volume and playback.Hold fn while you press them. Or open System Settings › Keyboard › Keyboard Shortcuts › Function Keys and turn on “Use F1, F2, etc. keys as standard function keys”.
fn (Globe)macOS never sends this key to a web page.If F1 – F12 light up only while you hold fn, then fn works.
Touch IDIt is a fingerprint sensor and power button, not a normal key.Test it by locking and unlocking your Mac.

These keys are drawn with a dashed border and are not counted in the total.

Frequently asked questions

Why do F1 to F12 not light up?

macOS uses them as media keys and handles the press itself. Hold fn and press them again.

A key stays lit after I let go. Is it stuck?

Usually not. While you hold command, macOS does not tell the browser when other keys are released. Release command and the test clears them. If a key stays bright green with no other key held, press it a few more times and compare.

Why can I not test Command-Tab or Command-Space?

macOS takes these shortcuts before the browser sees them. Press tab, space and command one at a time.

One key does not turn green. What now?

Press it several times, then test the same key in a text editor. If it fails in both places, the key or its connection is probably at fault. Cleaning around the key with compressed air is the usual first step. If that does not help, contact Apple Support or a repair shop.

Does the test record what I type?

No. The page reads which key was pressed and changes its colour. Key presses stay in your browser and are not sent to a server. See the privacy policy.

Does it work in Safari, Chrome and Firefox?

Yes. It runs in any current browser on macOS. No download and no account are needed.