UX Writing: How Microcopy Improves Digital Product Experiences
How UX writing and microcopy shape buttons, labels, forms, errors, empty states, onboarding and checkout, with examples, accessibility and testing tips.
Quick answer
UX writing is the practice of designing the words in an interface, the microcopy on buttons, labels, forms, errors, empty states and confirmations, so people understand what they can do, what's happening and what to do next. Good microcopy is clear, specific, concise and consistent, uses the user's vocabulary, and appears exactly where a decision or problem occurs. It reduces errors and support requests, makes products easier to learn and is essential for accessibility. Write it alongside the design, test it with users and keep it in the design system.
What Is UX Writing?
UX writing covers every word users read while using a product: navigation labels, buttons, field labels, hints, error and success messages, notifications and onboarding. The shortest of these are usually called microcopy.
It differs from marketing copywriting in purpose. Marketing copy aims to attract attention and persuade; interface copy aims to help someone finish a task without thinking about the words. The best microcopy is rarely noticed. Content design is a broader discipline that decides what content users need and in what form; UX writing is usually part of it.
Principles of Good Microcopy
| Principle | In practice | Example |
|---|---|---|
| Clear | Plain words users already use | “Delivery address” rather than “Consignee details” |
| Specific | Describe the actual result | “Download invoice” rather than “Submit” |
| Concise | Cut words that don't help | “Save” rather than “Click here to save your changes” |
| Useful | Answer the question users have at that moment | “Arrives by Thursday” next to a delivery option |
| Consistent | One term for one thing everywhere | Always “Remove”, never also “Delete” or “Discard” for the same action |
| Human | Polite and calm, especially when things go wrong | “We couldn't save your changes. Try again.” |
Buttons and Calls to Action
Start with a verb and say what happens. Users should be able to predict the result of a click from the label alone, and screen reader users often navigate by button names without surrounding context.
| Vague | Better |
|---|---|
| Submit | Create account |
| OK | Delete project |
| Continue | Continue to payment |
| Yes / No | Keep subscription / Cancel subscription |
| Learn more | See delivery options |
Navigation Labels
Navigation labels should match the words users would use, not internal team names or brand concepts. Put the distinguishing word first so labels scan quickly, avoid clever or ambiguous terms, and keep labels consistent with page titles. Test them with card sorting or tree testing as part of information architecture work; label changes are among the cheapest findability fixes available.
Forms: Labels, Hints and Placeholders
Every field needs a visible label that stays visible while typing. Placeholder text disappears as soon as users start, so it shouldn't carry labels or instructions. Put format hints (“DD/MM/YYYY”, “As shown on your card”) near the field, mark optional fields rather than scattering asterisks, and briefly explain why you need sensitive information such as a phone number.
Good form copy prevents errors instead of reporting them afterwards, which is exactly what the error prevention heuristic asks for.
Error Messages
Nielsen Norman Group's error-message guidelines come down to three things: make the error visible next to where it happened, explain the problem in plain language without blame, and help users fix it efficiently, including by keeping what they already entered.
| Poor | Better |
|---|---|
| Invalid input | Enter a phone number with the country code, for example +44 7700 900123 |
| Error 402 | Your card was declined. Check the details or use a different card. |
| Password incorrect | That password doesn't match this email. Try again or reset your password. |
| Something went wrong | We couldn't upload the file because it's larger than 10 MB. Choose a smaller file. |
Empty States
Empty screens appear when there's nothing to show yet, after a search or filter returns nothing, or after a user clears everything. Nielsen Norman Group's empty state guidelines recommend using them to communicate system status, help users learn the product and offer a direct path to the next task. An empty dashboard should say what will appear there and offer the one action that gets it started, not just show a blank area.
Success and Confirmation Messages
Success messages confirm what happened and, where relevant, what happens next: “Order placed. We've sent a confirmation to anna@example.com.” Keep them short and put them where users are looking.
Confirmation dialogs for destructive actions should name the action and the object: “Delete ‘Q3 report’? This can't be undone.” with buttons labelled “Delete report” and “Keep report”. Generic “Are you sure?” dialogs with “OK” and “Cancel” train users to click without reading. Where possible, offer undo instead of asking for confirmation.
Is your product's copy causing confusion?
ZSpace reviews and rewrites interface copy as part of UX work, from error messages to onboarding.
Onboarding Copy
Onboarding copy should get users to their first success quickly, not explain every feature. Tell users what they'll achieve, keep steps short, let them skip, and teach features in context when they're needed. The guide to mobile app onboarding covers the structure; microcopy is what makes each step feel short.
Checkout Microcopy
Checkout copy answers the questions that make buyers hesitate: what the total will be, when it will arrive, what happens if it doesn't fit, and whether payment is secure. Show delivery dates, not just delivery speeds; explain what a promo code field is for so it doesn't send users off to search for codes; label the final button with the action and amount where possible, such as “Pay £48.00”. See the checkout UX guide for the wider design.
Search Microcopy
A search placeholder can hint at what's searchable (“Search products, brands or order numbers”). No-results messages should confirm what was searched, suggest corrections or broader terms and offer ways to continue, such as popular categories. “No results” on its own is a dead end. See ecommerce search UX.
Microcopy and Accessibility
Many WCAG 2.2 success criteria depend on words. Forms need labels or instructions (3.3.2) and errors must be identified in text (3.3.1), with suggestions for fixing them where known (3.3.3). The purpose of each link should be clear from its text or context (2.4.4), so avoid “click here”. Status messages such as “Item added to cart” should be announced to assistive technology without moving focus (4.1.3). Images that convey information need text alternatives (1.1.1).
Plain language helps everyone: people using screen readers, people with cognitive disabilities, people reading in a second language and anyone in a hurry. See accessibility in UI/UX design.
Voice and Tone
Voice is the product's consistent personality; tone adapts to the situation. A playful voice can work in a celebration message and grate in an error message about a failed payment.
| Situation | Tone |
|---|---|
| First success | Warm, brief |
| Routine task | Neutral, efficient |
| Error or failed payment | Calm, direct, helpful; no jokes |
| Destructive action | Clear and serious |
| Security or privacy | Precise and reassuring |
Localization
Write so copy can be translated. Many languages need more space than English, so design components that allow text to grow rather than truncating it. Avoid idioms and wordplay, don't build sentences by joining fragments in code (word order differs between languages), handle plurals properly, and format dates, numbers, currencies and addresses for each locale. Keep a glossary so key terms translate consistently.
Building a Microcopy System
Treat copy like other design decisions. Keep a short content style guide covering voice, tone, capitalization and terminology; define standard messages for common states in your design system; write real copy in designs instead of placeholder text; and give developers final strings with the design so words aren't invented during build.
Testing UX Copy
- Include copy in usability tests and note where users hesitate or misread
- Ask users to explain in their own words what a message means
- Run highlighter tests: users mark words that help or confuse
- Review support tickets and chat logs for recurring confusion
- A/B test high-traffic copy, such as key buttons, where volume allows
- Check copy with screen readers and in every supported language
Common Microcopy Mistakes
- Generic buttons like “Submit” and “OK”
- Internal jargon or feature names users don't know
- Placeholder text used as the only label
- Error messages that blame users or give no fix
- Humour in stressful moments
- Several words for the same thing across the product
- Copy written after the design is finished
Want interface copy that helps users finish tasks?
Talk to ZSpace about UI/UX design with UX writing built in, and conversion reviews of key journeys.
Conclusion
Microcopy is design. Clear buttons, visible labels, helpful errors, purposeful empty states and honest confirmations make products easier to use and more accessible. Write words alongside layouts, keep them consistent through a design system and test them with users. For the visual side of interface clarity, see UI design principles and microinteractions.
Common questions
Writing the words inside a product's interface, such as buttons, labels, instructions, errors and notifications, so users understand what to do and what's happening. It's part of the design, not decoration added afterwards.