Write the Interface

A practical guide to writing clear, useful, and consistent interface copy.

Words are part of the interface.

UX writing is writing for the user experience. It covers every word that helps someone understand and use a product: buttons, labels, onboarding, empty states, notifications, tooltips, errors, and more.

The goal is not to decorate a screen. It is to put the right words in the right place, at the right time, with the right tone—so the product feels clear, confident, and easy to use.

That makes it different from marketing copy, which attracts attention, and editorial content, which informs. UX writing supports a task. A content designer works at the wider system level: planning, structuring, governing, and connecting content across the entire experience.

The discipline grew from content strategy and the earliest conversational interfaces. Today it extends beyond screens into smart devices, kiosks, voice products, and any experience where language helps a person make a decision.

UX writing Shapes the words people use while completing a task.

Content design Shapes the content structure, rules, and strategy around that task.

UX writing lives where people act.

Marketing copy earns attention. Editorial content informs. UX writing supports an interaction. It appears in small, contextual pieces of language often called microcopy.

OnboardingEmpty stateNotificationTooltipToastTitleCTAConfirmationLabelProgress updateAlertTransactional email

The interface may be a website, an app, a smart device, a chatbot, a kiosk, or a voice assistant. The surface changes; the responsibility does not. The words must help someone know what is happening and what they can do next.

Find the microcopy

UX writing is defined by where the words live and the job they do.

Select everything a UX writer would shape inside a product.

0 selected

Do not wait for the final screen.

UX writers work closely with designers, product managers, researchers, developers, support, and marketing. They contribute across the product cycle—not as a final proofreading step.

Discover

User interviews, verbatim analysis, UX audits.

Build

Prototypes, microcopy, glossary, voice and tone.

Deliver

User testing, A/B tests, measurement, iteration.

The writer and designer should work in the same file, inspect the same flow, and make decisions together. Space affects wording; wording affects hierarchy. Collaboration is the work, not a handoff around it.

Clear. Concise. Useful.

These three principles are the fastest way to assess interface copy. If the words fail one of them, the experience creates friction.

ClearUse familiar language. Avoid jargon and ambiguity.
ConciseRemove filler without removing necessary context.
UsefulAnticipate the next question and show the way forward.

Use active voice Name who does what.

Sound natural Write like a calm, helpful person.

Plan for translation Avoid wordplay that breaks across languages.

Stay consistent One concept should keep one name.

Choose good over vague

Specific copy reduces uncertainty and makes recovery feel possible.

A file upload stopped at 92%. Which message helps the user recover?

Replace the jargon

Rewrite the message. Your score rewards plain language, brevity, and a concrete next step.

Replace this

Authentication was unsuccessful due to invalid credentials.

0/180

Make the message understandable at first sight.

Put the most important information first. Use short sentences, active voice, and familiar words. If a technical term is essential, explain it where it appears. If it is not essential, replace it.

Lead with the point Do not make users read the setup before the answer.

Remove the unneeded Cut repetition, greetings, and filler that delay action.

Write for translation Avoid idioms, wordplay, and sentences built around English word order.

Name things once A project should not become a workspace, space, or folder elsewhere.

Keep one name

Consistency reduces the amount of interface language a user has to learn.

NavigationWorkspace

Page titleYour project

ConfirmationSpace created

All three labels describe the same thing. What should the team do?

Every component asks a different question.

A CTA predicts an action. An error helps someone recover. An empty state explains what belongs here. Loading copy manages waiting. Good UX writing begins with the component’s job, not a clever sentence.

CTA

Action + truthful outcome.

Loading

What is happening + whether to wait or act.

Onboarding

Benefit + one concept + visible progress.

Empty state

What belongs here + why it is empty + first action.

404

What happened + a route to something useful.

Error

Specific problem + recovery + alternative exit.

Use progressive disclosure: reveal the minimum needed for the current decision, then offer deeper detail close by. A tooltip cannot rescue a vague label, and onboarding cannot compensate for a confusing product.

Make the CTA tell the truth

A button label is a promise about what will happen after the click.

Hotel search

The button only checks whether rooms are available. It does not make a booking.

What should the button say?

Build an error message

A useful error protects the user’s progress and makes recovery concrete.

Card payment failed

The order is still in the basket and nothing has been charged.

Which details belong in the error message?

0 selected

Treat copy as a product decision.

A UX writing audit reviews a complete journey, not isolated sentences. Capture the screen, component, current copy, user goal, issue, proposed change, and evidence. Repeated problems reveal the system work behind the individual fixes.

Test important language in a prototype with the people who will use it. Watch whether they understand the state, predict the action, and recover from problems. For high-volume decisions, compare variants with an A/B test and measure the product outcome—not which sentence sounds nicer.

Comprehension Can people explain what the message means?

Prediction Can they tell what a button will do before selecting it?

Recovery Can they complete the next step without outside help?

Consistency Does the flow use the same terms, tone, and patterns?

Audit the flow

Look beyond grammar. Find the language problems that block understanding or action.

Profile transferMigration unsuccessful

A synchronization exception occurred.

Continue

Which problems would you record in a UX writing audit?

0 selected

Borrow language before you invent it.

Good interface language begins with evidence: interviews, support conversations, search queries, reviews, usability sessions, and the words people already use. Collect repeated phrases and the context in which they appear. That is semantic research.

A useful persona is not a fictional biography. It captures the user’s goal, situation, knowledge, anxieties, and vocabulary. Write for the decisions that person needs to make in the product.

Find the user’s language

Repeated phrases from research can reveal the label people will recognize fastest.

“I want to find the places I saved for later.”

“Where did my saved places go?”

“I save restaurants before a trip.”

What should the navigation label say?

Your voice stays. Your tone moves.

Voice is the product’s consistent personality. Tone adapts that voice to the situation. A celebration can be energetic; a payment problem should be calm. The user’s emotional state decides the volume.

When you try to speak to everyone, you end up speaking to no one.

Define voice with useful dimensions rather than loose adjectives. For example: direct rather than chatty, warm rather than playful, expert without sounding technical. For each dimension, show what “more” and “less” sound like in real components.

Tune the tone to the moment

Keep the same clear, human voice while adjusting the energy to fit the situation.

A bank transfer is taking longer than expected.

Turn good decisions into reusable guidance.

A content design system is the shared source of truth for interface language. It combines principles with examples teams can apply while designing and shipping—not a PDF that is opened once a year.

Voice and tone Principles, ranges, and examples for real situations.

Glossary Approved terms, avoided terms, definitions, and translations.

Patterns Guidance for errors, onboarding, empty states, CTAs, and notifications.

Governance Owners, contribution rules, review rhythm, and version history.

Keep the system relevant by reviewing support requests, store reviews, social conversations, new devices, and emerging interaction patterns.

Make the system clearer for everyone.

Accessible UX writing uses plain language, descriptive labels, short sentences, and context that does not depend on vision, color, or prior knowledge. Inclusivity is not a tone—it is the removal of barriers.

Do not communicate meaning through color, position, sound, or imagery alone. Write links and buttons that make sense out of context. Name the field with a visible label. Explain errors next to the affected input.

Reduce choices Hick’s Law: remove or group competing decisions.

Make targets predictable Fitts’s Law: labels should describe the action precisely.

Chunk information Miller’s Law: break dense instructions into meaningful groups.

Use familiar patterns Jakob’s Law: prefer language people already recognize.

Keep hierarchy simple Prägnanz: make the main message and action easy to perceive.

Inclusion goes further than technical access. Avoid assumptions about gender, relationships, ability, culture, or available resources. Ask only for information the task truly needs, and do not encode a “normal” user into labels or defaults.

In a voice or conversational interface, language becomes the interface. Design intents, repair paths, confirmations, and contextual responses. The user needs to know what the system understood and how to correct it.

Remove the barrier

Accessible copy communicates the same meaning without relying on a single sense.

A form has three required fields. Which instruction removes the most barriers?

Use AI to explore. Keep the judgment.

AI can generate alternatives, challenge a tone, simplify complex text, cluster feedback, or help audit a flow. It works best with a precise brief: user, context, goal, component, constraints, desired format, and examples from your content system.

Treat every output as a draft. Verify the product behavior, source claims, accessibility, terminology, tone, and privacy before anything ships. A strong workflow asks for several options, compares them against explicit criteria, and improves the brief from the failures.

The right words. The right moment.

Know the user, the component, the context, and the next action. Write clearly, remove what is unnecessary, and test whether the result truly helps.