The Mac Keyboard Viewer: seeing what each modifier key types

A document needs a degree sign, or a curly quote, or an e with an acute accent, and the keyboard has no label for any of them. The usual response is to search the web for the character and paste it, which works once and teaches nothing. macOS already ships the answer: a picture of the keyboard that redraws itself the moment a modifier key goes down, so the character and the keystroke that produces it are visible at the same time.

That tool is the Keyboard Viewer. It takes about two minutes to turn on, and it answers a class of question permanently rather than one character at a time. The part that trips people up is not the viewer itself but the menu it lives behind, which is off by default on many Macs and occupies a slot in a row that is usually already full.

What the Keyboard Viewer actually shows

Apple describes the tool in two halves, and both halves matter. The first is an onscreen keyboard that can be used to enter text by clicking. The second, and the reason most people end up opening it, is that it shows which keys to press on the physical keyboard to type letters with accent marks, symbols, and other special characters.

The second use is the one worth learning. The viewer is a live map of the current input source, not a static diagram. Whatever layout the system is set to right now is what gets drawn, including the punctuation positions that differ between a United States layout and a British or Japanese one. A keyboard that types an at sign in an unexpected place is not broken; the viewer shows immediately where the layout thinks that character lives.

Entering a character works either way round. Press the key on the physical keyboard that corresponds to the character shown, or click the key in the viewer itself. Clicking is slower but it is the only option when the physical key is dead, missing, or on a layout that the hardware does not have.

The window floats above other apps and can be moved and resized, which makes it usable alongside the document being typed into rather than as a separate detour. Leaving it open for an afternoon while working through a piece of text with unfamiliar punctuation is a reasonable way to use it.

Opening it, including when the Input menu is missing

The documented path is one click: click the Input menu in the menu bar, then choose Show Keyboard Viewer.

The Input menu is the small item at the top of the screen showing the current input source, often a flag or a two-letter code or a Japanese character. On many Macs, particularly ones set up with a single language, it is not there at all, and that is the point at which the instructions appear to fail.

Turning it on takes four steps. Choose Apple menu, then System Settings, then click Keyboard in the sidebar; Apple's own instruction adds the note that scrolling down may be needed to find it. Go to Text Input, click Edit, then turn on "Show Input menu in menu bar". The Input menu appears at the top of the screen immediately, and the one-click path above starts working.

There is a consequence of that setting worth stating in advance: it permanently adds an item to the menu bar. For a person who needs the Keyboard Viewer once a month, that is a slot spent on something used once a month, which is the trade-off the final section of this article deals with.

Two things people look for and do not find are worth naming. There is no default keyboard shortcut that opens the Keyboard Viewer, which is why the question comes up repeatedly on discussion sites. And it is not in the Applications folder as a separate app; it belongs to the system rather than being launched on its own.

Holding modifier keys is the whole technique

With the viewer open, press and hold one or more modifier keys. Apple names Option and Shift specifically, and the point is that the drawing changes under each one. The keyboard redraws to show what that combination produces, so a question like "where is the section sign" becomes a matter of holding Option and reading.

Four layers exist on a standard layout: the unmodified keys, Shift, Option, and Option with Shift held together. That last layer is where much of the typographic punctuation lives, and it is the layer almost nobody discovers by accident. Control and Command change the picture too, though on most layouts they produce commands rather than characters.

Which character sits under which combination depends entirely on the current input source. This is why lists of Option-key shortcuts copied from an article often disappoint: the article was written against one layout, and a reader on another gets something else. The viewer is authoritative in a way a list cannot be, because it is reading the layout in use at that moment.

One visual cue is easy to miss. When a key appears with an orange outline while a modifier is held, that key is a dead key: pressing it produces nothing on its own, and the accent it carries is applied to the next letter typed. That is the mechanism behind accented characters on a keyboard with no dedicated accent keys. Without knowing what the outline means, the behaviour looks like a key that does not work.

Other layouts, and why the viewer is the fastest way to read them

The viewer is not limited to the layout currently in use. Click the Input menu, choose a different input source, and the drawing changes to that layout. This is the quickest way to answer a practical question such as where the punctuation moves on a different national layout, or what a colleague's keyboard is doing, without changing anything permanently.

One caution belongs with that. Switching input sources to look at a layout also switches what the keyboard types, and Apple's instructions end with the reminder to change the input source back if it was changed to inspect a layout. Forgetting produces the classic symptom of quotation marks and the at sign arriving in the wrong places for the rest of the session.

There is a second, less obvious use for the same feature. Someone learning a second language input method can leave the viewer open to see which physical key maps to which character while the muscle memory forms, which is closer to the tool's original purpose than looking up a single symbol.

The Keyboard Viewer page in the Mac user guide points onward to two related topics that answer the questions it raises: entering characters with accent marks, and writing in another language on a Mac. It also points to specifying a keyboard type, which is the setting that matters when the hardware and the layout genuinely disagree, such as a keyboard bought in one country attached to a Mac configured in another. Reading the viewer first and then following whichever of those three applies is faster than guessing which of the three the problem belongs to.

Keyboard Viewer, Character Viewer, Accessibility Keyboard

Three related things are easy to confuse, and each one answers a different question.

Tool	The question it answers	Where it lives
Keyboard Viewer	Which keystroke types this character	Input menu, Show Keyboard Viewer
Character Viewer	Where is this character at all	Emoji and symbols, in the Edit menu or Input menu
Accessibility Keyboard	How to type without a physical keyboard	Accessibility settings, Keyboard

The dividing line between the first two is stated in Apple's own tip: to enter emoji, symbols, and special characters that do not appear in the Keyboard Viewer, use the Character Viewer. The Keyboard Viewer covers what the keyboard can produce, so anything outside that set, which includes most emoji and the long tail of mathematical and currency symbols, is a Character Viewer job. Searching by name is the Character Viewer's strength, and it is the faster route when the name of the character is known but its keystroke is not.

The third is a different tool that happens to share machinery. Apple notes that the Keyboard Viewer uses the macOS Accessibility Keyboard, which provides advanced typing features and additional options for navigating a Mac. A reader who wants dwell control, custom panels, or typing suggestions is looking at the Accessibility Keyboard rather than at the small viewer window, and it is enabled in Accessibility settings rather than in the Input menu.

The cost of the Input menu, and what to do about it

Everything above depends on one menu bar item being present. That row has a hard limit, and it is not the limit people expect.

Items at the right of the menu bar are pushed out by the menus of whichever app is in front. They do not collapse into an overflow list or a chevron. They stop being drawn, silently, and come back when a different app takes focus. On a MacBook with a notch, the centre of the row is unavailable, so the point at which items start disappearing arrives sooner. An app with a long menu bar of its own, such as a design tool or a spreadsheet, can hide several items at once.

This puts the Input menu in an awkward position. It is needed rarely, it is the only documented way to reach the Keyboard Viewer, and leaving it on costs a slot in a row where slots are already scarce. Turning it off after each use means walking through System Settings again the next time.

Turning it off is not free either. Once the Input menu is gone, the only remaining route to the Keyboard Viewer runs back through System Settings, Keyboard, Text Input and Edit, which is four steps to reach a window that was one click away. So the choice as usually framed is between a permanent slot and a four-step detour, and neither is appealing.

The way out is to stop treating the row as one undifferentiated queue. Items divide cleanly into three groups: the ones checked several times a day, the ones needed occasionally, and the ones that only need to exist. A menu bar manager for macOS keeps the first group in place, folds the second behind a divider where a single click brings it back, and hides the third permanently. The Input menu belongs in the second group, which means the Keyboard Viewer stays one or two clicks away without the menu taking up a permanent slot. How each of those three states behaves is set out on the Features page, and a tool of this kind needs Accessibility and Screen Recording permission to read and click the row, with the reasons given on the FAQ page.

What to change first

Turn on "Show Input menu in menu bar" in Keyboard settings, open the Keyboard Viewer once, and hold Option and then Option with Shift to see the two layers that were previously invisible. If the row at the top of the screen is already too full to spare a slot for a menu used twice a month, sort the row into always, sometimes and never first, which is what Koffret does.