Wording in Interfaces
Apr 11, 2026 · Updated 15 hours ago
Words make a wonderful interface. Very flexiable. And less terrifying than staring at the reality behind the screen.
Minecraft Ending Poems
Every word in an interface is a design decision. Even the punctuation. Strip away the colors, the shadows, the border radii, and what's left is text. That text is doing most of the work.
A pixel-perfect layout with lazy copy feels broken. A plain layout with precise copy feels professional. The gap between the two is not aesthetics. It's trust.
The interface is the product. Below are eight rules I keep reaching for, plus one final exam at the end. Each rule comes with quizzes as evidence. Let's train your judgement: read the rule, pick your answer (A or B?), and submit.
Label the outcome, not the category
Every clickable label is a promise about what happens next. Users don't read labels to learn what a thing is called; they read them to predict what clicking will do. If the prediction takes effort, the label has failed.
The same test applies to a step in a flow:
Synonyms are not interchangeable
English is full of near-synonyms that dictionaries treat as interchangeable but interfaces cannot. The wrong one shifts the tone, implies the wrong mental model, or adds a millisecond of hesitation.
Below, the user is taking a file out of one project. The file also lives in others:
This file will be deleted. Are you sure you want to proceed?
The file stays in your library and in the other projects that use it.
Every string must add information
Every string in an interface competes for a fixed budget of attention. A string earns its place by telling the user something they don't already know: what to type, what just happened, what's coming. A string that repeats what's already on screen isn't neutral; it's noise that trains users to stop reading.
It holds for form fields:
For the moment after an action:
And for the wait itself:
Never leave a dead end
Errors, empty results, disabled buttons: these are the moments when the user wanted something and didn't get it. The words there decide whether the moment ends the session or redirects it. A message that only announces failure is a wall; the job is to build a door.
An empty result is the same moment in disguise:
Even a disabled button can open a door:
Consequences, not fear
When an action is risky, the instinct is to escalate the warning language. But fear is not information. Users learn to click through scary words the way they learn to ignore cookie banners. What they can actually weigh is facts.
Are you sure you want to permanently delete this project? This action is irreversible and cannot be undone. All associated data will be permanently removed from our servers.
- 12 published posts will be unpublished
- 3 team members will lose access
- Cannot be undone
The same rule at a smaller scale:
Are you sure you want to leave this page? Any unsaved changes will be permanently lost. This action cannot be undone.
You've written 240 words since your last save.
Serve the user's intent, not yours
Copy quietly reveals who the product thinks it's for. Wording that mirrors the company's org chart, database, or git log makes the user do the translation. Wording that starts from what the user came to do makes the product do it.
Changelogs run the same test:
One concept, one word
The other side of synonyms: once you've picked a word, use it everywhere. Varying the noun or verb for the same thing makes users wonder if you mean something different. Elegant variation is for novels, not interfaces.
The same discipline holds in email:
This invitation was intended for hi@vercel.com.
This invite was sent on March 24, 2026, 12:55 AM (UTC) and will expire in 72 hours. This invite was sent from 204.13.186.218 located in São Paulo, Brazil. If you were not expecting this invitation, you can ignore this email. If you are concerned about your account's safety, please visit our Help page to get in touch with us.
Manage your notification settings
This invitation was sent to hi@vercel.com on March 24, 2026 at 12:55 AM (UTC) from 204.13.186.218 (São Paulo, Brazil). Expires March 27, 2026.
Didn't expect this? Safe to ignore. Concerned about your account? Visit our Help page.
Manage notification settings
Text has a shape
Before anyone reads a single word, they see the text as a shape: its length, its line breaks, its density. That shape is already a message. Be aggressively comfortable rewriting sentences to change the shape they make.
Can I cancel anytime?
Yes, you can cancel your subscription at any time from your account settings. Once you cancel, your current billing cycle will continue until the end of the period.
Please note that refunds are not provided for partial billing periods. If you cancel mid-cycle, you will retain access to all features until your current period expires.
If you have any questions about cancellation, our support team is available 24/7 to assist you.
Can I cancel anytime?
The shape is also literal:
Manage projects, tasks,
deadlines, milestones, and
budgets all in one shared
workspace.
One shared workspace for
projects, tasks, and budgets.
All the rules at once
One screen, every rule. Settings pages are where wording problems compound: every toggle is a bet on whether the user understands the current state of their own product. Every row below is a different sub-problem. Try the toggles.
The rules, in one list
- Label the outcome, not the category.
- Synonyms are not interchangeable.
- Every string must add information.
- Never leave a dead end.
- Consequences, not fear.
- Serve the user's intent, not yours.
- One concept, one word.
- Text has a shape.
Interfaces should sound like a helpful colleague: clear, concise, and human. Words compound: one well-written label is forgettable, but a hundred of them make software feel alive.
For non-English native speakers, establish strong English skill before you consider the wording.
I collected many details like these, free for everyone, on Detail.