KeyboardTester Logo
⌘

Mac Keyboard Test — Check Command, Option and Control

Test a MacBook or Magic Keyboard on a real Mac layout, with Command (⌘), Option (⌥) and Control (⌃) labelled the way macOS actually reports them.

READY
Press or tap any key
Live Key Display
Tested0/77Presses0Max Simultaneous0Progress0%
Tap keys on screen or swipe to view full layoutScroll ↔

Press physical keys or tap virtual keys above. Hover over keys for JavaScript keycode data.

Event Inspector

Press a key to see event details

Health Summary
Status○ Not Started
Keys Tested0 / 77
x

Total Presses

0

Max Rollover

0

Not Tested

Testing a Mac keyboard, and the macOS-specific things that trip people up

Mac keyboards are laid out and labelled differently enough from PC keyboards that a generic tester tends to confuse rather than help. The layout above uses the real arrangement: Command either side of the spacebar, Option outside it, Control at the far left, and the key marked Delete where a PC puts Backspace. The inspector shows which physical key sent each event alongside the modifier flags macOS set, which is what you need when a modifier seems to be sticking.

Two Apple-specific labels cause most of the confusion. The key marked Delete is Backspace — it deletes to the left, and forward delete is Fn plus Delete. Mac keyboards also have no Insert key at all, so if you are following instructions written for Windows, that key does not exist to test. Caps Lock behaves oddly on purpose too: macOS requires a slightly longer press before it engages, to stop accidental activation. A quick tap doing nothing is correct behaviour rather than a fault.

Being accurate about Command combinations, because the old version of this page overstated it: the page cancels Command shortcuts where a website is allowed to. Some are handled by macOS or the browser above the page and no website can block them — Command + Q and Command + W are the ones that will actually close things while you are testing. So test Command on its own to confirm the switch works, and avoid pairing it with W or Q. Everything else, including Command with letters, is safe here.

One more Apple quirk worth knowing before you conclude anything is broken: when macOS sees a keyboard it does not recognise, it runs the Keyboard Setup Assistant and asks you to press the keys beside each Shift to work out whether the board is ANSI, ISO or JIS. If that guess went wrong — easy to do by clicking through it — some keys will be mapped to the wrong characters permanently. It can be re-run from System Settings, under Keyboard, using Change Keyboard Type.

If your Mac is a laptop with a misbehaving key rather than a mapping problem, the laptop keyboard test covers the physical side, including the butterfly-mechanism failures that affect MacBooks from 2015 to 2019.

Key Capabilities & Features

Real Mac Layout and Legends

Command, Option, Control and Delete in their actual positions, with the symbols Apple uses rather than PC equivalents.

Left and Right Modifiers Separated

Both Command keys and both Option keys are tracked individually, so a fault on one side is not hidden by the other.

Modifier Flag Inspector

Shows the metaKey, altKey, ctrlKey and shiftKey state on every event, which is how you catch a modifier that is stuck down.

Command Shortcuts Suppressed

Command combinations are cancelled where a web page is permitted to, so most shortcuts will not fire while you test.

Media Row Included

The top row registers whether it is sending F-key codes or media and brightness codes, which answers the most common Mac F-key question.

Health Summary

Tracks the share of the layout confirmed, peak simultaneous keys and total presses across the session.

How to Perform This Test

  1. Click inside the keyboard area so the page has focus, then start with the modifiers: left and right Command, left and right Option, Control, and both Shift keys, each on its own.
  2. Top row: Escape, then F1 through F12. If they change brightness and volume instead of registering, that is the default — hold Fn to send the F-code.
  3. Letters and punctuation: type across all three rows, watching the character in the inspector rather than only the highlight. A mismatch there means a layout or keyboard-type problem, not a hardware one.
  4. Return, Delete and Space: tap each. Then try Fn plus Delete to confirm forward delete works, since that is a separate function on the same physical key.
  5. Caps Lock: press and hold it briefly rather than tapping. macOS deliberately requires a longer press, and the indicator light confirms it engaged.
  6. Arrow cluster: all four directions, then hold two adjacent arrows at once to check the compact cluster reports both.
  7. Read the health summary: it should approach 100 percent of the layout. Keys your keyboard does not physically have will stay dark, which is expected on a compact board.

Troubleshooting Common Hardware Issues

  • Command + W still closes the tab: that shortcut is handled above the page and no website can cancel it. Same for Command + Q. Test Command by itself, or paired with a letter that does not close anything.
  • Option produces accented characters instead of letters: that is correct macOS behaviour. Option plus E is a dead key that waits for a vowel to accent, and many Option combinations are deliberate symbol shortcuts. The inspector still logs the physical key, which is what matters for testing.
  • The Fn or Globe key never registers: expected. macOS handles it before any application sees it, so it emits no key event to a web page. This is true in every browser and is not a fault.
  • F1 to F12 control brightness and volume: that is the default. Hold Fn to send the real F-code once, or invert it permanently in System Settings › Keyboard with "Use F1, F2, etc. keys as standard function keys".
  • Some keys type the wrong characters: check your input source first — System Settings › Keyboard › Input Sources, where ABC and ABC Extended behave differently. If that is right, suspect the keyboard type: run Change Keyboard Type under System Settings › Keyboard so macOS re-identifies the board as ANSI, ISO or JIS.
  • Brief presses are ignored, or keys do not repeat: check Slow Keys and Sticky Keys under System Settings › Accessibility › Keyboard. Slow Keys deliberately adds a delay before a key registers and produces exactly the symptom of a keyboard that misses presses.
  • A Magic Keyboard is laggy or dropping keys: check the battery and the Bluetooth connection before the hardware. Plugging it in with a cable removes the wireless link from the equation entirely, which settles it in one step.
  • A PC keyboard on a Mac has Command and Option swapped: macOS maps the Windows key to Command and Alt to Option by default, but you can change it under System Settings › Keyboard › Keyboard Shortcuts › Modifier Keys, per keyboard.

Mac keys and their PC equivalents

Useful when following a troubleshooting guide written for Windows, which is most of them.

Mac keyPC equivalentWorth knowing
Command (⌘)ControlThe main shortcut modifier. Reported as the meta flag, not the control flag.
Option (⌥)AltAlso the symbol and accent modifier, which is why it produces odd characters.
Control (⌃)Control, partlyUsed for right-click and terminal shortcuts, not for copy and paste.
Delete (⌫)BackspaceDeletes to the left. Fn + Delete is forward delete.
Return (↩)EnterA separate Enter exists on full-size keyboards with a numpad.
— none —InsertMac keyboards have no Insert key at all.
Fn / GlobeFnNever reaches a web page. Handled by macOS itself.

Settings to rule out before blaming the hardware

macOS has several features that make a perfectly good keyboard behave badly, and all of them are more likely than a hardware fault. Work through these first.

Slow Keys. Under Accessibility › Keyboard. It requires a key to be held for a set period before it registers, so quick typing simply vanishes. If your keyboard seems to miss half of what you type, check this before anything else.

Sticky Keys. Also under Accessibility › Keyboard. Modifiers latch instead of needing to be held, which reads as Command or Shift being stuck down.

Input source. Under Keyboard › Input Sources. The wrong source gives you correct keys and wrong characters. ABC Extended in particular turns several Option combinations into dead keys that wait for a second keystroke.

Keyboard type. Under Keyboard › Change Keyboard Type. If macOS identified your board as the wrong physical standard, the keys near the Shift keys and Return will produce the wrong characters and no amount of cleaning will help.

Key repeat settings. Under Keyboard. Repeat can be turned off entirely, which looks like a key that will not hold. If a key seems to repeat on its own instead, that is the opposite problem and the stuck key test will show whether the key is being held down electrically. A key registering twice per press is a third thing again, measured by the double typing test.

Frequently Asked Questions

Does this work with a Magic Keyboard?
Yes, along with MacBook built-in keyboards and any USB or Bluetooth keyboard connected to a Mac. Browser key events are the same regardless of how the keyboard is attached. If a Magic Keyboard feels laggy or drops keys, check the battery and connect it with a cable before suspecting the hardware — that removes the wireless link from the equation in one step.
Can I test Command shortcuts safely?
Mostly. The page cancels Command combinations where a website is permitted to, so most will not fire. Two exceptions matter: Command + Q and Command + W are handled by macOS and the browser above the page, and no website can block them. Press Command on its own to confirm the switch works, and avoid pairing it with Q or W while testing.
Why is Backspace called Delete on a Mac?
Apple labels the key by what it does in the common case rather than by its PC name. The key marked Delete removes the character to the left, exactly like Backspace. Forward delete — removing the character to the right — is Fn plus Delete on compact keyboards, or a separate Delete key on a full-size layout with a numpad.
Why does the Option key produce accented characters?
Because that is its job in macOS text input. Option plus a letter produces a symbol, and several combinations are dead keys that wait for a second keystroke — Option plus E then a vowel gives an acute accent, for example. The key is working correctly. The inspector still shows which physical key you pressed, which is what a keyboard test needs.
Why does the Fn or Globe key never register?
macOS handles it internally and never passes it to applications, so no web page in any browser can see it. On newer Apple keyboards the same physical key is labelled Globe and switches input sources or opens the emoji picker, still without emitting a standard key event. This is by design rather than a limitation of this test.
How do I make F1 to F12 work normally on a Mac?
Hold Fn while pressing them to send the F-code once. To change it permanently, open System Settings › Keyboard and enable "Use F1, F2, etc. keys as standard function keys" — after which the media and brightness functions require Fn instead. Both directions are a preference, and neither indicates anything about the keyboard.
What happens if I use a PC keyboard on a Mac?
It works. macOS maps the Windows key to Command and Alt to Option, so the shortcut layout matches a Mac keyboard even though the legends do not. If you would rather they mapped differently, System Settings › Keyboard › Keyboard Shortcuts › Modifier Keys lets you reassign them, and the setting is remembered per keyboard.
Why does Caps Lock not respond to a quick tap?
Because macOS deliberately requires a slightly longer press before Caps Lock engages, to reduce accidental activation while typing. A quick tap doing nothing is correct behaviour. Hold it for a moment and watch for the indicator light, which confirms the switch is fine.
Some of my keys type the wrong characters. What is wrong?
Two settings cause almost all of these. First, the input source under System Settings › Keyboard — the wrong one gives correct keys and wrong characters. Second, and less well known, the keyboard type: macOS asks you to identify a new keyboard as ANSI, ISO or JIS, and if that guess went wrong the keys near Shift and Return are mismapped permanently. Re-run it with Change Keyboard Type in the same settings panel.

Related Tools

⌨️Full Keyboard Test⊞Windows Keyboard💻Laptop Keyboard🔧Function Keys📝Typing Speed Test⚠️Stuck Key Test