Content Design and Microcopy
Overview
Microcopy is the small text throughout an interface: labels, button text, error messages, hints. Content design is writing that text so it can be scanned quickly and understood immediately, rather than read carefully like an essay.
Why It Matters
People scan interfaces; they do not read them word for word. Vague labels and generic error messages force a reader to slow down and guess, right at the moment they are trying to complete a task, which is exactly when confusion is most costly.
Core Principles
- Every piece of microcopy has one primary job. Nielsen Norman Group's "3 I's" framework names them: to inform (headings, tooltips, context), influence (calls to action, brand tone), or help someone interact (button labels, placeholder text, state indicators).
- Write for scanning, not reading. Front-load the important word; cut anything that does not change what the reader does next.
- Error messages name the problem and the fix. "Something went wrong" tells a reader nothing they can act on.
Interactive Demo
Error: invalid
Vague version: generic label, a placeholder with no example, and an error message that names no problem and suggests no fix.
Common Mistakes
- Generic button labels like "Submit" or "OK" instead of naming the actual action ("Create account," "Send invoice").
- Error messages that describe the system's internal state ("Error 400") instead of what the reader should do next.
- Writing microcopy in long, formal sentences when a fragment would be scanned faster and understood just as well.
Related Concepts
- Navigation and Information Architecture: navigation labels are microcopy applied to structure.
- Forms and Inputs: error message timing and placement both depend on this concept's writing principles.
Used In Templates
Demonstrated directly in the Small Business and Local Service Site, Landing Page, SaaS Pricing Page, Nonprofit and Charity Site, Online Course Landing Page, Community and Forum Homepage, Newsletter and Waitlist Signup Page, Multi-step Onboarding Flow, Job Board and Careers Page, and FAQ and Help Center Page templates; see docs/PRD.md section 13.2.
Summary
Microcopy is small but constant: it appears on every button, every field, every error. Writing it to inform, influence, or help someone interact, clearly and specifically, is what makes an interface feel considered rather than assembled.