Write the interface

Learn to write labels, buttons, and messages that help people use your product. Practice with ten short exercises.

Help people take the next step

UX writing helps people understand what a product does and how to use it. A button names an action. A field label explains what to enter. An error message helps someone recover when a task fails.

Compare “Submit” with “Save changes.” The second label tells you what will happen. That is the job of interface copy: give people enough information to act with confidence.

Use this guide to choose clearer labels, write helpful messages, and review a product flow. Try the exercises as you go, or read through first. All examples are for practice.

Try it · Profile settings

This is how your name appears on your profile.

UX writing names the action: “Save changes.” Content design decides which fields belong together and where the confirmation appears.

Recognize microcopy

Microcopy is the short text that guides an interaction. Its purpose matters more than its length: a slogan attracts attention, while a password hint helps someone finish a task.

OnboardingEmpty stateNotificationTooltipSuccess messageTitleButton labelConfirmationLabelProgress updateAlertTransactional email

These words appear in apps, websites, kiosks, and voice assistants. At each step, ask: what does the person need to know now, and what can they do next?

Find the microcopy

Choose the examples that help someone use a product. You can select more than one.

Which examples guide a product interaction? Select all that apply.

0 selected

Write while you design

UX writers work closely with designers, product managers, researchers, developers, support, and marketing. Start with the user’s goal and write the copy while the flow is still taking shape.

Discover

Listen to users. Collect their words and questions.

Build

Write in the prototype. Check each action and state.

Deliver

Test understanding. Improve and document the copy.

Review the flow together. Can someone skip this step? What happens if saving fails? Does “Delete” mean permanent deletion? Agree on the behavior before writing a promise the product cannot keep.

Give every word a job

Review your draft in four passes. Start with what the person needs, then make the wording shorter, more natural, and easier to understand.

PurposefulDoes it help someone decide, act, or recover?
ConciseCan you cut words without losing needed context?
ConversationalWould you say this to someone asking for help?
ClearWill people understand what happens next?

Shorter is not always clearer. “File too large” names the problem. “Choose a file under 10 MB” also explains how to fix it. Keep the details someone needs to finish the task.

Choose a helpful error message

Compare the messages. Which one explains what to do next?

An upload paused when the internet connection dropped. The product can resume it. Which message helps someone continue?

Replace the jargon

Rewrite this sign-in error in everyday language. Explain the problem and give a next step.

Replace this

Authentication was unsuccessful due to invalid credentials.

The email and password don’t match. Help someone check their details and try again. Limit: 180 characters.

180 characters left

Put the important words first

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.

Example · Email and account messages
Before

To continue, you will need to verify your email.

After

Verify your email to continue

Open the verification link we sent to alex@example.com.

The heading puts the next action first. The supporting line explains how to complete it.

Keep one name

A workspace, project, and space may sound like different things. Keep one name for the same concept.

NavigationWorkspace

Page titleYour project

ConfirmationSpace created

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

Match the words to the component

Start with the question someone has at that moment. What will this button do? Why is this list empty? Did my changes save? Use the component to answer it.

Button

Name the action and object: “Save changes” or “Download invoice.”

Loading

Describe the current task: “Uploading your file…” Only show progress you can measure.

Onboarding

Explain one useful step: “Choose a language to find lessons.”

Empty state

Explain what belongs here: “No saved places yet. Save a place to find it here later.”

Success

Confirm the result: “Changes saved.” Add a next step only if one is needed.

Error

Name the problem and a way forward: “Upload failed. Choose a file under 10 MB.”

Put essential instructions beside the action. Give form fields visible labels, and keep requirements outside placeholders that disappear during typing. Offer extra detail when it is useful.

For errors, explain the cause only when you know it. Say what was saved or charged only when the product can confirm it. Before a permanent action, state the consequence and name both choices: “Delete draft” and “Keep draft.”

Name the button’s action

Choose a label that matches what the button actually does.

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

Choose the details someone needs after a failed payment. Then review an example message.

Card payment failed

The order is still in the basket and nothing has been charged. The person can try another payment method. The cause is unknown.

Which details belong in the error message? Select all that apply.

0 selected

Test the words in the flow

A UX writing audit reviews a complete journey, not isolated sentences. Capture the screen, component, current copy, user goal, issue, proposed change, and evidence. Fix the problems that prevent someone from finishing before polishing less important wording.

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. For example, test whether a clearer booking label helps people find a room. Check completed bookings and accidental actions as well as clicks.

Try it · File upload

Your file is too large

trip-notes.pdf is 12 MB. Choose a file under 10 MB.

Can you explain why the upload failed, predict the next action, and finish without help? The file name stays consistent throughout.

Find the copy problems

Review this error screen. Select every issue that makes it harder to understand or recover.

Profile transferMigration unsuccessful

A synchronization exception occurred.

Continue

Which problems affect this screen? Select all that apply.

0 selected

Use words your readers recognize

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. Use them to propose labels, then test whether other people understand those labels in the product.

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

Read the fictional research excerpts. Choose a label that reflects the words these people use.

“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?

Adjust the tone to the situation

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 and specific. Consider the person’s goal, likely concerns, and the consequences of the action.

Routine confirmation

Changes saved

Confirm the result. Keep it brief.
First use

No saved places yet

Save a place to find it before your next trip.

Explain what belongs here and how to start.
Something failed

We couldn’t load your places

Check your connection, then try again.

Name the problem and give a recovery step.
Permanent action

Delete “Weekend in Paris”?

This deletes the list and its saved places. You can’t undo this.

State exactly what will be lost.

Document your voice with examples. If it is clear, warm, and direct, show how those qualities work in a welcome, an error, and a confirmation. Keep humor out of moments when someone may lose work or money.

Choose a tone that fits

Try both situations. Choose a message that respects how the person may be feeling.

A bank transfer is taking longer than expected. The product will notify the sender when it completes.

Document the decisions you repeat

A content design system is the shared source of truth for interface language. Start with the decisions your team keeps making: which terms to use, how to explain errors, and what each button should say.

Example · A reusable content pattern

When someone saves a place

Use a short confirmation. Keep the feature name “Saved places” in navigation and help text.

Added to your saved places

Use after saving succeeds. If saving fails, explain the problem and offer a retry. Avoid “Repository” and “Collection” for this feature.

Owner: the team responsible for saved places.

Store the wording, its intended use, and its owner together. Review the pattern when the product behavior changes.

A glossary entry can be simple: “Saved places” means places someone has bookmarked. Use it in navigation and headings; avoid “Repository” for the same feature. Include the reason, an owner, and a review date.

Remove barriers to understanding

Accessible UX writing uses plain language, descriptive labels, short sentences, and context that does not depend on vision, color, or prior knowledge. Check whether someone can understand the task while using a screen reader, reading in a second language, or working in a hurry.

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.

Try it · Delivery details

Choose your delivery date

  1. Enter an email address for delivery updates.
  2. Choose a future delivery date.

Use a made-up address to try this example.

Try a past date to see the error message.

Read the delivery policy

For this example, any future date is available. In a real checkout, explain available days and delivery costs here.

The labels stay visible while you type. Required fields use text, the date error explains the fix, and the policy link names its destination. Nothing is sent or booked.

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 presumed user into labels or defaults. “Emergency contact” leaves room for more relationships than “Husband or wife.”

In a voice or conversational interface, language becomes the interface. Explain what it understood, confirm consequential actions, and let people correct mistakes.

Remove the barrier

Compare two form instructions. Choose the one people can understand without seeing color.

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

Use AI to draft alternatives

AI can generate alternatives, challenge a tone, simplify complex text, group feedback, or help review a flow. Give it the user’s goal, the product’s actual behavior, the component, and any constraints. Include examples of your voice and preferred terms.

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.

Try it on one screen

Choose a screen in your product. Write down what someone needs to do, revise the words that might slow them down, and ask another person what they expect to happen next.