This is good UX writing
Eight principles for every interface you’ll ever write.
![A marker drawing the letters UX.](https://miro.medium.com/v2/resize:fit:1000/1*B8TrE0fPkZI43i7JaLAzyw.png)
A few years ago, someone emailed me with a question: What makes UX writing good? They knew the basics, they said. And they knew what good writing looked like. But they wanted to know specifically about UX writing. How to think about it and evaluate it, what approach to take when staring down a blank page or struggling with a new design.
I emailed back a couple paragraphs about using words to improve interfaces and how to better integrate writing into a design team. They thanked me for my reply, and that was that.
But the question stuck with me. It’d be in the back of my mind when I was working on a new app or crafting the content approach for an interactive tool. I thought about it every time I wrote anything: an onboarding flow, a button, an error message. What makes UX writing good?
Three years later, I emailed back another answer. A better one. I told them, these are my Principles of UX Writing. They shape every digital product I’ve ever written.
Here’s what I wrote.
Good UX writing improves the user experience.
It makes flows simpler, actions clearer, and choices easier. It reduces complexity and lets people do what they want. It makes sure nobody gets lost or confused or frustrated.
![One search bar just says “search.” The other gives a suggestion and says, “Try ‘action movies.’”](https://miro.medium.com/v2/resize:fit:1000/1*qJ__v1JD6RntJsWbM8vdMQ.png)
Good UX writing tells the truth.
It explains and clarifies without trying to mislead or hide information. It writes with the appropriate level of urgency. If it doesn’t know the answer, it doesn’t make one up.
![One e-commerce listing shouts “Selling out fast!” The other says simply, “17 pairs available.”](https://miro.medium.com/v2/resize:fit:1000/1*ouIVlNjG4iV2gZl6aXBjkA.png)
Good UX writing includes everybody.
It respects different genders, ethnicities, abilities, sexual orientations, and backgrounds without judgement or discrimination. It considers screen readers and alt-text.
Good UX writing says the right thing at the right time.
It tells people what they need to know, paying attention to context, intent, and emotion. It puts the most important information first. It cuts what it can and simplifies the rest.
![One screen shows a complicated order number and a link to more details. The other says the name of the item and delivery date](https://miro.medium.com/v2/resize:fit:1000/1*MPg20sxjag8rpWDtFPDBIw.png)
Good UX writing serves a functional purpose.
It does more than “balance out” a design. It guides and explains. It enhances structure and adds personality. It exists because the interface would be worse without it.
Good UX writing is sometimes no writing at all.
It goes away when it’s not needed.
![Images of interfaces without words: a calendar, a clock, and a calculator.](https://miro.medium.com/v2/resize:fit:1000/1*Cwf3eGGcv8dT46au62hbfw.png)
Good UX writing stays consistent.
It follows a messaging framework and writes with a core set of vocabulary. It sometimes changes its tone, but it always sounds like the same brand voice. It has predictable patterns and structure.
![Two screens from an interface with a consistent, playful brand voice that uses emojis.](https://miro.medium.com/v2/resize:fit:1000/1*_MkxOhNSDk3V1OTlg6LtLQ.png)
Good UX writing is good writing.
It uses the same tools and techniques as all writing, including diction, syntax, grammar, point of view, punctuation, rhythm, and style. It understands which rules to follow and why. It breaks those rules when it has a good reason.