Field Notes
All posts

Writing microcopy that disappears

The best interface text is the text nobody notices, because it said exactly what was needed and nothing more.

Small words, big effect

Microcopy is the small text throughout an interface: button labels, field hints, error messages, tooltips, confirmation dialogs. Individually each piece is a few words. Together they determine whether a product feels clear or confusing.

The goal is not cleverness. It is clarity so complete that the reader never stops to think about the words.

Buttons name their action

A button labeled "OK" or "Submit" says nothing about what will happen. A button labeled "Delete project" or "Send invoice" tells the person exactly what they are about to do. In a dialog, both buttons should name actions: "Delete project" and "Keep project" are clearer than "Yes" and "No".

Cut the helper text

Interfaces accumulate explanatory sentences: a line under every heading, a paragraph above every form, a hint beside every field. Most of them restate what the control already makes obvious. Each one adds reading time and dilutes the text that actually matters.

A useful rule: a sentence earns its place only if it carries a fact the person cannot get from the control itself and needs at that moment.

Errors explain and guide

An error message should answer two questions: what went wrong, and what can I do about it. "Something went wrong" answers neither. "We could not save your changes because you are offline. They will save automatically when you reconnect" answers both.

Avoid blaming the user. "You entered an invalid date" puts them on the defensive; "Enter the date as month, day, year" simply helps.

Be consistent

If one screen says "Delete" and another says "Remove" for the same action, people wonder whether they are different. Pick one term for each concept and use it everywhere. A short glossary shared across the team prevents drift.

Sentence case

Sentence case, where only the first word and proper nouns are capitalized, reads more naturally and is easier to scan than title case. It also removes endless debates about which small words to capitalize.

Write for scanning

People rarely read interface text word by word. They scan for the word that matches their intent. Put the important word first: "Billing settings" scans better than "Settings for your billing".

Read it aloud

The quickest test for microcopy is to read it aloud in context. If it sounds stilted, robotic, or longer than you would say to a colleague, rewrite it. If it sounds like a helpful person saying exactly what you need to know, it is done.