UX Writing and Content Design
UX writing and content design are the practice of writing and shaping the words inside an app or website: button labels, form hints, error messages, menus, and onboarding text. The aim is that a person can finish a task without stopping to puzzle over the wording. It treats interface text as part of the design, planned from user needs and research rather than added as a final polish.
itWeb development | OpenSkills.info
Course pathWalk it in order
Look it upDip in anytime
Go furtherLeaves this page
Don't Panic
Don't Panic — UX Writing and Content Design
Somewhere in every app is a person staring at a button, trying to work out what it will do to them. UX writing and content design is the practice of making sure they do not have to guess: writing and shaping the words inside a product, from button labels to error messages to the cheerful screen that appears when a list is empty.
The words used to be an afterthought. Teams built the screens with placeholder text, then asked someone to fill in the copy a week before launch, by which point the wording had to fit around decisions nobody could change. Content design moves the words to the front, on the grounds that they are part of the design and not a coat of paint applied at the end. Get a label wrong and you are not editing a sentence later, you are rebuilding a screen.
Three ideas hold up the rest. The first is that people scan rather than read; eye-tracking studies found most people never go through a page word by word. So the useful information goes first, and each paragraph carries one idea, because the second idea gets skipped.
The second is that plain language wins even with experts. Doctors and engineers prefer short, common words too, because they are trying to finish something, not admire anyone's vocabulary. Write for a low reading age and the specialists are not offended; they are relieved.
The third is that voice stays still while tone moves. The product keeps one personality across every screen, but it is encouraging during setup and briefly, plainly apologetic when a payment fails. Same character, different room.
What tends to surprise people is how little of this is about sentences. Interface words decide navigation, form structure, and what belongs on which screen, which is why a writer brought in at the end spends their time covering a bad structure with helper text and tooltips.
The other surprise is error messages. The instinct is to be reassuring or witty. The guidance is almost the opposite: say what happened, say how to fix it, put it next to the field that broke, keep whatever the person already typed, and never call their input invalid, which reads as an accusation. A joke in an error message is funny once and grating by the fourth time the same thing fails.
If you read one more tab, make it the Intro, which lays out the whole model without assuming you have ever written a line of product copy. Keep the Cheatsheet open while you work: the microcopy shapes, the plain-language swaps, and the error checklist are all in tables there. The Practice Reference turns it into steps you can run on a real screen, and Field Notes covers what breaks when a team tries this at scale, which is mostly a scheduling problem wearing a writing costume.
Where this skill leads
Relevant careers
See how this topic contributes to broader role-level skill maps.
Sources
- https://guidance.publishing.service.gov.uk/writing-to-gov-uk-standards/plan-manage-content/understand-content-design/
Supports
- Definition of content design as starting from a user need
- Choosing the best format rather than defaulting to prose
- Content that is understandable, memorable, and actionable
- https://www.gov.uk/service-manual/design/writing-for-user-interfaces
Supports
- Content is part of the design, not decoration
- Front-loading and cutting unnecessary words
- Avoiding sensory-only instructions such as "click the green button"
- Meaningful link text and consistent terminology
- Avoiding humor in error messages
- Working with designers from the start
- https://gds.blog.gov.uk/2012/01/11/its-all-about-the-words/
Supports
- Editorial work is fundamental to design
- Predecessor government sites padded content with caveats and edge cases
- Design for the common case; understand, remember, act
- https://gds.blog.gov.uk/2016/02/23/writing-content-for-everyone/
Supports
- Writing for low literacy helps every reader
- Content should be understandable, memorable, and actionable
- Use direct phrasing such as "you must"
- https://design.homeoffice.gov.uk/accessibility/written-content/readability
Supports
- Recommended maximum reading age of 9, even for a specialist audience
- Short, clear sentences are easier for everyone
- Define acronyms on first use
- https://www.nngroup.com/articles/how-users-read-on-the-web/
Supports
- 79 percent of users scan a new page; 16 percent read word by word
- F-shaped scanning and the weight of the first words
- One idea per paragraph; inverted pyramid
- Concise, scannable, and objective text tested best, and best combined
- Promotional language imposes a cognitive burden
- https://www.nngroup.com/articles/ux-writing-study-guide/
Supports
- UX writing addresses people's contexts, needs, and behaviors
- Plain language benefits all users, including experts
- Tone influences brand perception
- Measurement of content through task and support signals
- https://www.nngroup.com/articles/3-is-of-microcopy/
Supports
- Microcopy is text shorter than three sentences
- The three purposes: inform, influence, interact
- Each piece written to one primary purpose
- https://www.nngroup.com/articles/error-message-guidelines/
Supports
- Error messages should be visible and placed in context
- Plain language, not system codes; precise, not "an error occurred"
- Constructive fixes and a non-blaming tone; avoid "invalid" and "illegal"
- Preserve user input; avoid humor that stales on repeat
- Modal dialogs only for severe errors
- https://www.nngroup.com/articles/plain-language-experts/
Supports
- Domain experts also prefer plain, scannable writing
- Experts read to complete a task quickly
- https://www.nngroup.com/articles/content-strategy-vs-ux-writing/
Supports
- Content strategy sets the framework and governance
- UX writing produces user-facing copy to that framework
- Content design structures and presents content; roles overlap
- https://www.nngroup.com/articles/tone-of-voice-dimensions/
Supports
- Four dimensions of tone of voice
- Keep brand personality consistent; vary tone by context and the reader's state
- https://digital.gov/guides/plain-language
Supports
- The Plain Writing Act of 2010 requires plain language in US federal public content
- Plain-language techniques: audience, active voice, common words, short sentences, testing
- https://www.w3.org/WAI/tips/writing/
Supports
- Descriptive page titles and section headings
- Link text that describes the destination; avoid "click here"
- Clear instructions and error messages; state required input formats
- Expand abbreviations on first use
