Skip to content
UX Atlas
UX writingCraft conventionFoundational

Microcopy

The small pieces of text that do most of the work: labels, hints, empty states, errors and confirmations.

Definition

Microcopy is the functional text embedded in an interface. It is usually written last, changed most often, and responsible for a disproportionate share of whether a design works.

Craft convention. True because the industry converged on it. Breaking it costs familiarity, not correctness.

On this page
  1. Definition
  2. Rewrites that carry weight
  3. Rules
  4. Sources
  5. Continue from here

Rewrites that carry weight

WeakBetterWhy
SubmitCreate accountNames the outcome rather than the mechanism.
ErrorYour card was declinedSays what actually happened.
No resultsNo results for "blue chairs"Confirms the query and points at the cause.
Learn moreHow refunds workDescribes the destination, and works out of context for screen readers.
Are you sure?Delete 12 files permanently?States the consequence and the scope.
Something went wrongWe could not save your changes. Retry?Gives a next action.

Rules

  • Label buttons with the verb of what happens next.
  • Write in the second person and the active voice.
  • Front-load the important word, since people scan the first two or three words of a label.
  • Be specific about numbers, names and outcomes.
  • Write error messages that could be read aloud to a customer without embarrassment.
  • Keep terminology identical across the interface, help centre, emails and support scripts.

Sources

Where a source establishes something narrower than the popular reading of it, the note says so.

  • Microcopy: The Complete Guide

    K. Yifrah, 2017

Each link says what the connection is, so you can tell a principle from an alternative from a thing people mix this up with.

Principles behind this

The reasoning this solution is an application of.

Practical example

A worked decision where this was the deciding factor.

Short definition

The one-paragraph version, for when that is all you need.

Related concept

Connected closely enough to change how you apply this.