KLD Institute
Course mapOpen slides

Week 3 tutorial notes

UX Writing 101: Clear Words, Clear Decisions

Audit and rewrite one product screen as a content system, including user need, copy jobs, plain-language rewrites, accessibility checks, terminology control, tone choices, and one product decision.

Lesson thesis

Interface words are product behavior. Headings, labels, hints, buttons, links, state messages, errors, and helper text frame the task, guide action, reduce uncertainty, support accessibility, and protect trust.

Preparation status

Prepared with study notes, references, and web examples.

Study notes

1. Lecture spine

Session 7 moves from interface actions to interface language. The central teaching point is that words are part of the product surface. They tell the user what the screen is for, what information is needed, what will happen next, what state the system is in, and how to recover from a problem.

This lecture should avoid treating writing as a beauty exercise. The question is not: Does this sound nicer? The stronger question is: Does this help the user complete the task with less uncertainty, less effort, and less risk?

The artifact is a clear interface text rewrite. It should include the original screen copy, the job of each text moment, a rewrite, a rationale, accessibility notes, terminology choices, and one product decision.

  1. 01Part 1Words as interface behaviorShow that interface words are not decoration. They frame the task, guide input, explain state, set expectations, and support recovery.
  2. 02Part 2The vocabulary of UX writingIntroduce user need, copy job, plain language, terminology, headings, labels, hints, action text, state copy, tone, and accessibility.
  3. 03Part 3Worked examplesRewrite examples from a product recommendation screen and an onboarding form, always preserving meaning and explaining the product decision.
  4. 04Part 4Studio practiceLearners annotate one screen, run the AI critique prompt, rewrite the screen as a content system, and present one priority decision.

2. What UX writing is really doing

The learner should understand the difference between writing a sentence and designing interface content. Interface text has a job in a system. It sits beside layout, actions, states, data, and policy.

A useful beginner distinction is this: content design decides what content is needed and where it belongs; UX writing shapes the words people see in the interface; microcopy is the small text that helps at the exact moment of decision.

The session should also challenge a common misconception. Plain language is not childish. It is precise language chosen for the user situation. Expert users also benefit from clear, scannable, direct writing because they are busy and task-focused.

Content design

The practice of planning, structuring, writing, and managing content so people can meet a real need.

Example: Deciding whether a screen needs an explanation, a form question, a warning, or a changed flow.

UX writing

Writing the interface words people use while completing a task.

Example: Writing headings, labels, button text, helper text, empty states, success messages, and error messages.

Microcopy

Small pieces of interface text that guide a user at the moment of action or decision.

Example: Password hint, Save button label, field error, tooltip, or success toast.

Plain language

Language the intended audience can understand and act on without unnecessary effort.

Example: Use "Check your details" instead of "Commence verification process".

3. Start with user need and copy job

A rewrite should start from the user need. Without this, learners may make copy shorter but less useful. A short label that hides consequence is not better. A warmer error message that does not help recovery is not better.

The copy job is the bridge between product thinking and writing. For example, the job of a page title is to orient. The job of a form label is to name expected input. The job of a button is to predict an action. The job of an error is to help recovery.

For product ownership, this creates a repeatable review method: user need, copy inventory, copy job, rewrite, risk check, decision.

  1. 01Step 1State the user needWrite who the user is, what they need to do or understand, and why it matters now.
  2. 02Step 2Inventory the textList the copy moments on the screen: heading, label, hint, action, link, message, error, and state copy.
  3. 03Step 3Name the copy jobName what each text moment should help the user know, decide, enter, trust, or fix.
  4. 04Step 4Rewrite and check riskRewrite only after the job is clear, then check whether the rewrite preserves meaning.

4. Scanning and information scent

People often scan an interface before reading it carefully. This does not mean they are careless. It means they are looking for the fastest path to task completion.

Good interface text supports scanning by putting important words first, using descriptive headings, avoiding vague link labels, and making repeated patterns predictable.

A useful teaching exercise is to ask whether the screen still makes sense if the learner only reads headings, field labels, buttons, and links. If those elements do not carry the task, the screen may be depending on body text that many users will miss.

Scannable copy examples
Page heading
Weak: Delivery options
Strong: Choose a delivery time
Section heading
Weak: More information
Strong: Items arriving tomorrow
Link
Weak: Click here
Strong: Change delivery address

5. Plain language and precision

Plain language is often misunderstood as removing complexity. The better definition for this course is: say the necessary thing in the clearest responsible way for this user, task, and context.

Some specialist terms are necessary. The learner should not remove legal, safety, pricing, eligibility, or technical meaning just to make a sentence shorter. Instead, explain the term the first time it appears, then use it consistently.

Plain language also includes structure. A paragraph can use simple words and still fail if the important answer is buried at the end.

Plain language without losing meaning
Verb
Weak: Commence
Strong: Start
System phrase
Weak: Verification in progress
Strong: We are checking your details
Eligibility
Weak: Eligibility criteria not satisfied
Strong: You cannot apply yet
Specialist term
Weak: APR, unexplained
Strong: Annual percentage rate (APR)

6. Headings as task signposts

Headings are interface structure. They help the user scan, predict what is coming, and understand where they are in a flow. For screen reader users, headings can become a navigation map.

A good heading is descriptive enough to stand apart from the paragraph below it. It does not need to be clever. It needs to help the user recognize the task, topic, or decision.

Question headings can be useful in forms because they align with the user decision. However, they must still be clear and connected to the controls that answer the question.

Headings that orient
Heading job
Weak: Add a decorative phrase.
Strong: Tell the user what this part is for.
Good heading
Weak: Almost there
Strong: Payment method
Good question heading
Weak: Address
Strong: Where should we send your order?

7. Labels, hints, and input confidence

Labels and hints are the copy most closely tied to successful input. A label should tell the user what information is expected. A hint should add information the label cannot carry: format, consequence, example, or context.

A common beginner mistake is to use placeholder text as the only label. Placeholder text disappears during input and can be harder to review after typing. A visible label gives the user a stable reference point.

Labels should be reviewed with errors. If the label says Delivery postcode, the error should usually repeat that language so the relationship is clear.

Labels and hints
Field label
Weak: Contact
Strong: Email address
Choice label
Weak: Email
Strong: Receive updates by email
Hint
Weak: Enter email
Strong: Use the email address you check most often
Placeholder
Weak: Use as the only instruction.
Strong: Use as example only, not as the only label.

8. Buttons, links, and action promises

Action text is where writing and interaction meet. A button label is not just a word. It is the visible promise of behavior. The learner should ask: If I press this, what do I expect will happen?

Generic labels can work when the context is obvious and the risk is low. But when money, data, deletion, eligibility, or submission is involved, the label should usually be more predictive.

Link text should describe the destination, object, or result. Avoid relying on nearby text to make a generic link meaningful. Link text should still be understandable when read out of context.

Action and link copy
Primary action
Weak: Next
Strong: Review order
Risky action
Weak: Confirm
Strong: Delete shortlist
Link
Weak: More
Strong: View refund policy
Instruction
Weak: Click the green button
Strong: Select Continue

9. State and system messages

State copy helps the user understand what is true right now. Empty, loading, success, warning, and confirmation messages all change the user sense of progress and trust.

The copy should not overpromise. Loading text should not say something is complete before it is complete. A success message should confirm the result and, when useful, point to the next action.

Empty states are especially useful for beginners because they show that a blank area can still teach. A good empty state explains what is missing, why, and what the user can do next.

State copy examples
Empty state
Weak: No items
Strong: No saved laptops yet. Save one from your recommendations.
Loading
Weak: Please wait while we process your request at this time
Strong: Checking availability...
Success
Weak: Success
Strong: Saved to shortlist. View shortlist.
Warning
Weak: Warning
Strong: This removes 3 saved recommendations.

10. Error and recovery copy

Session 6 introduced errors as action-state behavior. Session 7 focuses on the words. A good error message should help the user recover, not merely announce that the system is unhappy.

For form errors, the message should be specific to the actual problem. Empty, too long, too short, wrong format, and disallowed characters are different problems and often need different messages.

The tone should be calm and non-blaming. If the system failed, say so. If the user needs to change something, give the next action.

Recoverable errors
Empty required field
Weak: Required
Strong: Enter your first name
Wrong format
Weak: Invalid email
Strong: Enter an email address in the correct format
System problem
Weak: An unknown error occurred
Strong: Could not save. Your changes are still here. Try again.
Error copy checklist
  • Name the field or object.
  • Say what happened in plain language.
  • Tell the user how to fix it when they can act.
  • Preserve input where possible.
  • Avoid blame, jokes, codes, and vague labels.

11. Tone, voice, and inclusion

Voice is the consistent character of a product. Tone changes with context. A product can have a friendly voice while using a calm, direct tone during errors, payments, deletion, eligibility, and personal data moments.

The learner should be careful with humor and personality. Personality that feels delightful in onboarding can feel dismissive during a failed payment or lost data moment.

Inclusive tone avoids judging the user, assuming identity or ability, or making the user feel blamed for a system or product limitation.

Tone choices
Low stress
Weak: Boom! We did the thing!
Strong: Saved to shortlist
High stress
Weak: Oops, something weird happened
Strong: Payment was not taken
Eligibility
Weak: You failed the requirements
Strong: You cannot apply yet

12. Accessibility for interface words

Accessibility makes UX writing more concrete. Descriptive headings and labels help users navigate, remember, and complete tasks. Labels and instructions help people understand what information is expected.

The learner should check both visible text and accessible meaning. A screen reader user should not receive a weaker or more confusing version of the task.

Copy should also avoid instructions that depend only on visual position or color, such as click the green button or use the box on the right. The instruction should refer to the meaningful label or action.

Accessibility review checklist
  • Headings describe the topic or task.
  • Labels describe expected input or selection.
  • Visible labels are available to everyone, not only assistive technology.
  • Buttons and links have names that make sense when isolated.
  • Hints and errors are connected to the relevant field or control.
  • Instructions do not rely only on color, shape, size, or location.

13. Terminology as a product system

Terminology is product architecture because it shapes the mental model. When a product uses different words for the same concept, the user may wonder whether the meaning changed.

A small terms list can prevent this. The list should include the preferred term, terms to avoid, and a short explanation of the concept.

Product owners should treat inconsistent vocabulary as a real product issue. It can cause support questions, onboarding friction, and mismatched implementation across teams.

Terminology control
Product object
Weak: Recommendation, option, item, match used interchangeably
Strong: Recommendation
Saved area
Weak: Shortlist, favourites, saved list, basket
Strong: Shortlist
User action
Weak: Save, add, store, keep
Strong: Save recommendation

14. AI UX writing critique lab

AI is useful for generating rewrite options, finding inconsistent terms, checking tone, and spotting missing copy states. But it can also produce polished copy that removes necessary meaning.

The learner should use the prompt to force structure. AI should name the copy job first, then rewrite, then explain risk. This helps prevent surface-level editing.

The human decision is essential. The learner should accept useful phrasing, adapt it to the product context, and reject anything that invents behavior, hides consequence, or reduces accessibility.

Session 10 prompt lab
I am reviewing the words on a product screen or short flow.

Context:
- Product:
- User:
- User task:
- Situation or stress level:
- Desired outcome:
- Current screen copy:
- Known constraints:

Review the copy as a UX writer and product owner.

1. Identify every important text moment: page title, heading, field label, hint, button, link, empty state, loading message, success message, warning, error, confirmation, and helper text.
2. For each text moment, name the job it should do for the user.
3. Find weak copy: vague words, jargon, hidden assumptions, duplicated text, missing instructions, blameful error language, inconsistent terms, unclear links, and labels that do not describe the expected input or action.
4. Rewrite the copy in a table with columns: current copy, copy job, proposed rewrite, why it is clearer, what risk remains.
5. Check accessibility: descriptive headings, visible labels, useful instructions, clear link purpose, and whether a screen reader user would understand the same task.
6. Check tone: helpful, calm, direct, inclusive, and appropriate for the user situation.
7. Check terminology: choose the preferred term for each concept and flag words that should not be mixed.
8. Suggest one product or design change if copy alone is trying to fix an unclear interface.
9. Finish with one priority decision: I would improve ___ first because ___.

Rules:
- Do not invent new product behavior.
- Do not remove legal, safety, pricing, or eligibility meaning.
- Use common words unless the specialist term is necessary.
- Prefer clarity over personality.
- Keep the user's task more important than brand voice.
Check before accepting
  • Does the prompt provide the user, task, context, current copy, and constraints?
  • Does the answer identify the job of each text moment before rewriting?
  • Does it preserve legal, pricing, safety, eligibility, and product meaning?
  • Does it improve headings, labels, hints, actions, links, states, and errors?
  • Does it check accessibility and terminology consistency?
  • Does it flag when copy is trying to repair an unclear interface?
  • Does it finish with one priority decision?
Reject or revise when
  • The answer only makes the copy shorter.
  • The answer invents new product behavior or removes necessary warnings.
  • The answer makes copy more playful during a serious moment.
  • The answer ignores labels, headings, links, or accessibility.
  • The answer gives many rewrites but no product decision.

15. Worked example: recommendation screen

The course project example is a recommendation experience. This is a useful copy exercise because it includes product objects, filters, actions, and saved states.

The weak version says Your results, Budget, Save, and No items. None of these are completely wrong, but they are thin. They force the user to infer what kind of results, what budget means, what Save saves, and where saved items go.

The stronger version names the object and destination: recommended laptops, maximum price, save laptop to shortlist. The product decision is to improve the action and empty-state copy first because those moments affect trust and repeat use.

Product recommendation rewrite
Title
Weak: Your results
Strong: Recommended laptops for your study needs
Filter label
Weak: Budget
Strong: Maximum price
Card action
Weak: Save
Strong: Save laptop to shortlist
Empty state
Weak: No items
Strong: No saved laptops yet. Save one from your recommendations.

16. Studio exercise, rubric, and home study

The studio output is a clear interface text rewrite. It should not be a random list of improved sentences. It should show system thinking: user need, copy jobs, rewrites, rationale, risk, accessibility, terminology, and decision.

For home study, the learner should collect one confusing screen and rewrite it using the same structure. The tutor should ask the learner to defend one rewrite that became longer because it preserved important meaning.

The lecture can close by reminding learners that a Product Owner with design specialist capability should be able to explain why important words are present, what they help the user do, and what product risk they reduce.

  1. 01Part AChoose the screenSelect one existing screen or course project screen with at least eight text moments.
  2. 02Part BAnnotate the textMark the heading, labels, hints, buttons, links, state messages, errors, and helper text.
  3. 03Part CRewrite as a systemFor each text moment, write the user need, copy job, rewrite, rationale, and remaining risk.
  4. 04Part DReview and decideCheck accessibility, tone, terminology, and whether the interface itself needs to change.
Rubric for a strong UX writing artifact
  • Names the user, task, context, and desired outcome.
  • Inventories at least eight important text moments.
  • Explains the job of each text moment before rewriting.
  • Uses plain language without removing necessary meaning.
  • Improves headings, labels, hints, actions, links, states, and errors.
  • Checks accessibility for headings, labels, instructions, and link purpose.
  • Creates a short terminology list with preferred and avoided terms.
  • Ends with one priority product decision and a reason.

Follow-up reading for the lecturer

GOV.UK Service Manual: Writing for user interfacesGOV.UK Service Manual guidance on writing for transactional interfaces: short, direct, inclusive copy that helps people complete tasks without extra explanation.GOV.UK: Writing for GOV.UKGOV.UK content design guidance on writing for the web, meeting user needs, using plain English, and structuring content for scanning.GOV.UK: User needsGOV.UK guidance on writing user needs from the user perspective before choosing content or interface solutions.Digital.gov: Plain Language Web Writing TipsDigital.gov guidance on writing web content around audience, task order, scannability, plain language, descriptive links, and testing with real users.Digital.gov: Principles of plain languageDigital.gov plain language principles: define the audience, use active voice, organize information, and test whether people understand the intended message.W3C WCAG: Labels or InstructionsW3C guidance on labels and instructions for inputs, including why visible guidance matters for people who need to understand what information is expected.W3C WCAG: Headings and LabelsW3C guidance on descriptive headings and labels, with accessibility benefits for scanning, memory, navigation, and form completion.Material Design: WritingMaterial Design writing guidance on simple, concise, direct language, consistent terminology, user-focused phrasing, and action-oriented UI text.GOV.UK Design System: Error messageGOV.UK Design System guidance on error messages that are specific, concise, matched to labels, and written to help the user recover.Shopify Polaris: Inline errorShopify Polaris guidance on inline errors that are brief, contextual, specific, and tied to the relevant field for assistive technology.Apple HIG: Text fieldsApple guidance on text fields, including visible labels, placeholder limits, appropriate input support, and validation at the right time.Material Web: ButtonsMaterial Web guidance that button labels should describe the action that will occur, with accessibility support for more descriptive labels when needed.

References

GOV.UK Service Manual: Writing for user interfaces

GOV.UK Service Manual guidance on writing for transactional interfaces: short, direct, inclusive copy that helps people complete tasks without extra explanation.

GOV.UK: Writing for GOV.UK

GOV.UK content design guidance on writing for the web, meeting user needs, using plain English, and structuring content for scanning.

GOV.UK: User needs

GOV.UK guidance on writing user needs from the user perspective before choosing content or interface solutions.

Digital.gov: Plain Language Web Writing Tips

Digital.gov guidance on writing web content around audience, task order, scannability, plain language, descriptive links, and testing with real users.

Digital.gov: Principles of plain language

Digital.gov plain language principles: define the audience, use active voice, organize information, and test whether people understand the intended message.

W3C WCAG: Labels or Instructions

W3C guidance on labels and instructions for inputs, including why visible guidance matters for people who need to understand what information is expected.

W3C WCAG: Headings and Labels

W3C guidance on descriptive headings and labels, with accessibility benefits for scanning, memory, navigation, and form completion.

Material Design: Writing

Material Design writing guidance on simple, concise, direct language, consistent terminology, user-focused phrasing, and action-oriented UI text.

GOV.UK Design System: Error message

GOV.UK Design System guidance on error messages that are specific, concise, matched to labels, and written to help the user recover.

Shopify Polaris: Inline error

Shopify Polaris guidance on inline errors that are brief, contextual, specific, and tied to the relevant field for assistive technology.

Apple HIG: Text fields

Apple guidance on text fields, including visible labels, placeholder limits, appropriate input support, and validation at the right time.

Material Web: Buttons

Material Web guidance that button labels should describe the action that will occur, with accessibility support for more descriptive labels when needed.

Web examples

Guided practice

Inventory screen copy, classify headings, labels, hints, actions, links, states, and errors, run the Session 10 prompt, revise the copy, and defend the highest-priority improvement.

Artifact: Interface copy system with rewrite rationale, terminology, accessibility notes, and priority decision
Tutor review questions
  • Can the learner start from user need before rewriting copy?
  • Can the learner identify the job of each text moment?
  • Can the learner improve headings, labels, hints, buttons, links, states, and errors without removing necessary meaning?
  • Can the learner explain terminology choices and avoid mixing words for the same concept?
  • Can the learner check accessibility for headings, labels, instructions, link purpose, and assistive descriptions?
  • Can the learner decide when copy alone is trying to fix an unclear interface?
AI prompt
I am reviewing the words on a product screen or short flow.

Context:
- Product:
- User:
- User task:
- Situation or stress level:
- Desired outcome:
- Current screen copy:
- Known constraints:

Review the copy as a UX writer and product owner.

1. Identify every important text moment: page title, heading, field label, hint, button, link, empty state, loading message, success message, warning, error, confirmation, and helper text.
2. For each text moment, name the job it should do for the user.
3. Find weak copy: vague words, jargon, hidden assumptions, duplicated text, missing instructions, blameful error language, inconsistent terms, unclear links, and labels that do not describe the expected input or action.
4. Rewrite the copy in a table with columns: current copy, copy job, proposed rewrite, why it is clearer, what risk remains.
5. Check accessibility: descriptive headings, visible labels, useful instructions, clear link purpose, and whether a screen reader user would understand the same task.
6. Check tone: helpful, calm, direct, inclusive, and appropriate for the user situation.
7. Check terminology: choose the preferred term for each concept and flag words that should not be mixed.
8. Suggest one product or design change if copy alone is trying to fix an unclear interface.
9. Finish with one priority decision: I would improve ___ first because ___.

Rules:
- Do not invent new product behavior.
- Do not remove legal, safety, pricing, or eligibility meaning.
- Use common words unless the specialist term is necessary.
- Prefer clarity over personality.
- Keep the user's task more important than brand voice.

Home study

Choose one confusing product screen with at least eight text moments. Annotate each text moment, name its job, rewrite it, explain the rationale, list terminology choices, check accessibility, and choose one priority improvement.