Wording in Interfaces

· Updated at

Every word in an interface is a design decision. 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. Let's train your judgement. For each part below, ask yourself before checking the answer: which one is better, A or B?

Onboarding Questions

Step 1 of 3
What's your role?
Step 1 of 3
What will you use Acme for?
A
B
Reveal answer

The better option is B.

Role-based questions sort people into buckets the company already decided on. Intent-based questions ask the user what they came here to do — and implicitly promise to help them do it. The phrasing reveals whether the product serves the user or the user serves the product.

"What's your role?" is a demographic question disguised as personalization — it helps the company's analytics dashboard, not the user. The options (Designer, Engineer, PM) are the company's mental model, not the user's. "What will you use Acme for?" flips the frame: now the options describe outcomes the user actually wants (build a website, write and publish). It signals that the product will adapt to their intent, not file them into a segment.

Settings Labels

Every row below is a different sub-problem. Try the toggles.

Require a code to sign in
Adds a verification step to protect your account
Send me email notifications
Dark Mode
Reduces eye strain in low-light environments
Billing
Renew automatically
Your plan renews on the 1st of each month
Enable two-factor authentication
Notifications
Dark Mode
Enable dark mode for the application.
Advanced
Disable auto-renewal
A
B
Reveal answer

The better option is A.

Settings pages are where wording problems compound. Every toggle is a bet on whether the user understands the current state of their own product.

Five issues in one panel. B names the technology ("two-factor authentication"), uses a bare noun ("Notifications"), negates itself ("Disable auto-renewal"), dumps leftovers into "Advanced", and writes a description that repeats the title. A describes the experience ("Require a code to sign in"), gives toggles a clear on-state ("Send me email notifications"), uses positive phrasing ("Renew automatically"), names the real category ("Billing"), and writes a description that adds new information ("Reduces eye strain"). Same settings, completely different clarity.

Button Labels

A
B
Reveal answer

The better option is A.

A button label is a promise — it tells the user what will happen when they click.

"Help" is a noun — it names a category, not an action. "Get Help" is a verb phrase — it tells you what will happen. Same with "Desktop App" (what is it?) versus "Download Desktop App" (now I know what clicking does). "Become a Pro" assumes the user is "not" Pro; "Upgrade Plan" is concrete and actionable.

Placeholder Text

A
B
Reveal answer

The better option is B.

"Enter keywords" describes the mechanic — type words into a box. The user already knows that. "Search issues, projects, pages" describes the scope — it tells the user what the search covers, which is the thing they actually need to know.

In a search field, the question is never "what do I physically do?" — it's "what can I find here?" Naming the searchable objects turns the placeholder into a feature discovery surface.

A
B
Reveal answer

The better option is B.

"Subscribe to newsletter" repeats the button's job — the user can already see "Subscribe" right there. Placeholder text that echoes the action wastes the one chance to communicate something the user actually needs: what to type.

An example email like "contact@rene.wang" does two things at once: it shows the expected format (an email address) and implicitly answers "what goes here?" without the user having to think. Showing an example is almost always more helpful than describing the field.

Error Messages

This email is already registered. Try signing in instead.
Invalid input.
A
B
Reveal answer

The better option is A.

The worst error messages communicate failure without offering a path forward. The best ones don't feel like errors at all.

"Invalid input" is a wall. "This email is already registered — try signing in instead" does three things at once: it names the problem (duplicate email), explains why (already registered), and offers a next step (sign in). It transforms a frustrating moment into a helpful one.

Confirmation Messages

Successfully Saved.
Your changes to “Project Alpha” have been saved.
A
B
Reveal answer

The better option is B.

The user just did something. The system should echo back what they did — not just that it worked. The difference matters most at scale: three saves in a minute, multiple tabs open, a dozen actions in a session.

A generic "Success!" leaves users wondering what succeeded. Did the save go through? The publish? The delete? A specific confirmation like "Your changes to Project Alpha have been saved" echoes back the action and the object, closing the loop. Vague reassurance is not reassurance — it's noise.

Empty States

No results found.
No results for “fluxcap
Try a different keyword or check your spelling.
A
B
Reveal answer

The better option is B.

The user had intent — they typed a query, navigated somewhere with a purpose, and came up short. That moment of unmet expectation is the most overlooked in interface design. Most teams treat it as a non-moment. But it's actually the moment with the highest leverage over whether the user tries again or leaves.

"No results found" is a dead end — a closed door with no signage. Echoing back the user's query ("No results for fluxcap") proves the system heard them correctly. Suggesting a next step ("Try a different keyword or check your spelling") opens a new door. Users who hit a helpful empty state try again. Users who hit a bare one leave.

Destructive Actions

Warning: Permanent Deletion

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.

Delete “Landing Page”?
  • 12 published posts will be unpublished
  • 3 team members will lose access
  • Cannot be undone
A
B
Reveal answer

The better option is B.

The default instinct is to escalate fear — WARNING, permanent, irreversible, cannot be undone. Three synonyms for the same thing, and the user still doesn't know what they'd actually lose. Fear-based copy becomes noise. Users learn to click through it the way they learn to ignore cookie banners.

B lists factual consequences: 12 posts unpublished, 3 teammates locked out. Now the user can actually weigh the decision. Even the button labels differ — "Cancel" is a generic escape hatch; "Keep project" reframes the safe option as a positive choice. Fear is not information. Consequences are.

Email Copywriting

To:hi@vercel.com
Subject:You've been invited to join Acme Inc.

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

To:hi@vercel.com
Subject:Invitation to join Acme Inc.

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

A
B
Reveal answer

The better option is B.

Interface copy gets reviewed in Figma. Email copy gets pasted into a template at 11pm. Users notice the difference in care. Two rules I apply: use consistent nouns throughout, and never use relative dates.

A switches between "invitation" and "invite" three times — a subtle but real inconsistency that erodes trust. It also uses "will expire in 72 hours," forcing the reader to calculate the actual deadline. B uses "invitation" consistently, states the expiration as an absolute date (March 27, 2026), and condenses the security disclaimer from a wall of text into two direct sentences. Every improvement is about respecting the reader's time and attention.

Changelogs

v2.4.0
NewYou can now switch to dark mode from Settings
FixPDFs no longer export as blank pages on Firefox
FixYour exports now include custom fonts
v2.4.0
NewAdded dark mode support
FixFixed an issue that content may be blank in PDF export
FixFixed custom font rendering issue
A
B
Reveal answer

The better option is A.

A changelog is a retention marketing surface disguised as documentation. Every line is an opportunity to remind users why they pay — or an opportunity to sound like a git log nobody reads. The shift is simple: describe the outcome, not the change.

B reads like a git log — it describes what engineers did, using internal language ("support", "rendering issue", "bug"). A speaks directly to the user: "You can now..." and "Your exports now include..." reframe every change as something the user gained. It also names the specific problem that was fixed ("blank pages on Firefox") instead of the vague "bug in PDF export". Users don't care about your bugs — they care about their workflows.

Loading Copy

A
B
Reveal answer

The better option is B.

When the product is slow, the copy is the product. Loading copy is the only moment where the interface has to justify its own existence in real time.

"Please wait..." is empty — it tells you nothing about what's happening or how long it'll take. B names the action ("Generating your report"), sets an expectation ("about 6 seconds"), and shows a live elapsed counter that proves the system is still working. When a delay is unavoidable, the copy's job is to make the wait feel intentional rather than broken.

Disabled Tooltips

Custom Domain
Use your own domain for published sites
Custom Domain
Use your own domain for published sites
A
B
Reveal answer

The better option is A.

A disabled button is a desire signal. The user hovered or clicked — they wanted this. That moment of intent is precious, and the tooltip is your one chance to convert it.

"Available on Pro plan" names the gate — it tells the user they can't, full stop. "Unlock custom domains → Pro" names the reward — it echoes back the thing the user wanted and connects it to the path forward. Same five words, completely different emotional direction. The first tooltip explains why you can't. The second reminds you why you'd want to.

Answer Length in FAQ

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?
Yes. No fees, no questions.
A
B
Reveal answer

The better option is B.

The length of a response is itself a message, separate from the words. A one-sentence answer feels confident. A three-paragraph answer feels like it's hiding something — or selling. "Can I cancel anytime?" is the most trust-sensitive question a user can ask.

A is technically accurate and thorough — but thoroughness is the problem. When someone asks "Can I cancel?", they want a yes or no. Three paragraphs of qualifications, edge cases, and support reassurances signal that the real answer is complicated. "Yes. No fees, no questions." is five words and total confidence. It answers the question, addresses the two anxieties behind it (cost and friction), and stops. Brevity is trust.

Synonyms

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. These three pairs come up constantly.

"Submit" vs "Send"

Contact Us
Contact Us
A
B
Reveal answer

The better option is B.

"Submit" comes from paper bureaucracy — you submit a form, then wait for someone to process it. "Send" comes from conversation — you send a message, and it reaches someone. A contact form is closer to a conversation than a government filing.

"Submit" also strips away the object — submit what? "Send" is direct and conversational. It implies the message will reach someone, not disappear into a queue.

Retry vs Try again

Couldn't load your messages
Please check your connection and try again.
Couldn't load your messages
Please check your connection and try again.
A
B
Reveal answer

The better option is A.

"Retry" is a developer term that leaked into the UI. No one says "retry" in conversation — they say "try again." The prefix "re-" is Latin-derived and formal. "Again" is plain English and human.

This matters most in error states, where the user is already frustrated. Technical language at a frustration peak makes the product feel cold. Conversational language makes it feel like a partner acknowledging the hiccup.

Continue vs Next

ShippingPaymentReview
Shipping address
Jane Doe
123 Main St, San Francisco, CA 94102
ShippingPaymentReview
Shipping address
Jane Doe
123 Main St, San Francisco, CA 94102
A
B
Reveal answer

The better option is B.

"Next" is directional but empty — next what? It assumes the user remembers the sequence. "Continue to payment" names the destination, which does two things: it confirms where the user is going, and it sets expectations for what they will see.

In a multi-step flow, every click forward is a small trust decision. Naming the destination reduces the cost of that decision to near zero. "Next" asks the user to trust blindly. "Continue to payment" shows them the path.


Notes

  • Interfaces should sound like a helpful colleague — clear, concise, and human.
  • Words compound. One well-written label is forgettable. A hundred of them make software feel alive.
  • For non-English native speaker, establish strong English skill before you consider the wording.
  • I collected many details like these which are free for everyone on Detail.