Content Design

Content design focuses on shaping information so users can find, understand, and act on it easily. It combines writing, structure, and strategy to meet both user needs and organizational goals. Content is not a final layer added to a finished design, but a design material in its own right. The words in an interface are often the most important design decision you can make.

Key Concepts

  • Content-first thinking: The words, labels, and messages in a product should be designed before and alongside the interface, not written afterward. Content shapes the user's mental model of what they're doing and why.
  • Dual goals: Every piece of content must serve two sets of goals at once — organizational goals (security, compliance, task completion) and user goals (speed, clarity, confidence).
  • Collaborative ideation: Effective content design involves input from diverse team members across technical, legal, financial, and design disciplines, as well as a variety of user perspectives. No single person holds all the context needed to write content that is both accurate and usable.
  • Iteration and testing: Content is never finished on the first draft. Refine it through user research, usability testing, surveys, card sorting, tree testing, and heatmaps to validate whether it is understood and effective.
  • Awareness of constraints: Good content design accounts for business constraints, technical limitations, display contexts (mobile vs. desktop), and localization needs from the very start.

Writing for Your Audience

The right content strategy depends heavily on who you're writing for.

Public-facing content serves people who are often in a hurry. They skim and scan, looking for the quickest path to completing their task. Plain language is essential — it builds trust, reduces errors, and ensures that people at a wide range of reading levels can succeed. Use second-person ("you"), active voice, and simple sentence structures. Avoid jargon.

Internal or federal workforce content can be slightly more technical when your audience has domain expertise, but clarity and precision still matter. Match the vocabulary to what your audience already knows, and explain acronyms when they're introduced.

Consideration Public-facing Internal/federal workforce
Reading level target 8th grade or lower Match to audience expertise
Vocabulary Plain language, avoid acronyms Can use domain terminology with explanation
Second person Yes ("you") Yes ("you")
Active voice Always Always
Tone Friendly and helpful Professional and helpful

In either case, the goal is the same: help the person understand where they are, what they need to do, and what will happen next.

Voice and Tone

Voice is consistent, reflecting the organization's character and should be recognizable across the entire product experience. Tone shifts to suit context. You can recognize someone's voice regardless of whether they're being serious or playful; the same is true for a product.

Common voice styles include:

  • Friendly — warm, casual, conversational (e.g., Slack)
  • Professional — formal and precise, prioritizing clarity over warmth (e.g., IBM)
  • Witty — uses humor and wordplay to create memorable moments (e.g., MailChimp)
  • Formal — polished and respectful, suited to high-stakes or traditional contexts (e.g., luxury brands)

Tone, meanwhile, adjusts to the situation. An informative tone works for feature explanations. An empathetic tone is essential for error states and failures. An encouraging tone fits goal-completion moments. The voice chart helps writers shift tone intentionally without losing the product's consistent character.

A voice chart is a practical tool for maintaining this balance. It documents how a product's core principles should express themselves across dimensions like concepts, vocabulary, verbosity, grammar, punctuation, and capitalization. This gives writers and designers a shared reference for making content decisions consistently.

Login.gov Voice Chart Example

Friendly Informative Helpful
Concepts Welcoming, more than happy to connect customers to the services they pay for via taxes Concise, matter-of-fact explanations that anyone with an 8th grade reading level can understand Always offering help or additional support when needed, especially when users run into issues
Vocabulary How would you like to... Let's... Thanks for your patience! Humanize public facing content. Use 'people', 'residents', 'persons' when possible. Plain language. We recommend you... Some tips include... Having trouble? Here's what you can do: How it works. Want to learn more?
Verbosity Be concise except when there is an opportunity for gratitude or to accentuate user success. No adjectives or adverbs except when recommending more secure or efficient authentication options: "Add your government employee ID for a faster, more secure sign in" Explanations are detailed but concise, providing solutions for all the issues users could run into.
Grammar Conversational language. Use the second person pronoun "You" as subject set in active voice. Use contractions: you'll, you're, you've, we'll. Use "we" to refer to Login.gov when speaking to the user. Complete sentences. Active voice. Use "must" "need" and "have to" instead of "should" if an action is required. Don't use "will" or other versions of passive voice. Complete sentences. Active voice. Explain acronyms before using them throughout a text. For example: "Trusted Travelers Program (TTP)"
Punctuation No periods in titles and headings. Use exclamation points sparingly and only in positive contexts. No periods in titles and headings. No periods in titles and headings. Parentheticals only for explaining acronyms.
Capitalization Sentence case titles, headings, buttons. Title case only reserved for proper nouns. Sentence case titles, headings, buttons. Title case only reserved for proper nouns. Sentence case titles, headings, buttons. Title case only reserved for proper nouns.

Errors, Alerts, and Breaks in the Experience

What happens when something goes wrong is often the most important content in a product. Users remember errors. How you handle them shapes trust.

There are three categories of breaks in the experience, each requiring a different content approach:

Inline errors are the least disruptive. They appear adjacent to the field or element that caused the problem.

✗ Don't
Use technical jargon or vague language to describe an error and leave users guessing what to do next.
✓ Do
Keep the text short, clarify what went wrong and what the user should do to fix it, without stopping their flow entirely.

Detour errors interrupt the user's path but can be resolved within the product. Lead with what the user needs to do before the explanation. Make sure the call-to-action matches words in the heading, so that even if the user skips the body text, they can still move forward successfully.

✗ Don't
Only provide users with the error message and no other way to resolve the issue.
✓ Do
Provide users with a clear explanation of what went wrong and give them a clear call to action to continue.

Blocking errors occur when the way forward is completely blocked until the user takes action outside the product's scope — a planned outage, a 404, or a security breach.

✗ Don't
Leave users with a cryptic message that lacks additional context or gives them any idea when the experience will return.
✓ Do
Be specific. If you know when the experience will be available again, say so. If not, explain the conditions under which the user can return.

Across all error types: speak to users directly, respectfully, and in plain language. Don't lead with technical jargon. Apologize only when appropriate, and keep the focus on what the user can do next.

Research Methods for Content Design

Content designers need to understand not just what users do, but what words they use to describe what they're doing. The vocabulary users bring to a product is the vocabulary that will cost them the least effort to process. Those are the words that people scan without feeling like they're reading.

Useful research methods for content design include:

  • Moderated usability testing: Watch users interact with the product or a prototype. Pay attention to moments of hesitation, misreading, or re-reading. These often signal content problems.
  • Unmoderated testing: Useful for validating specific content decisions at scale with less facilitation overhead.
  • User surveys: Collect data on knowledge, expectations, and preferences. Watch for social desirability bias, sampling bias, and question framing that can skew results.
  • Card sorting: Reveals how users categorize and label concepts, which is especially useful for navigation and information architecture decisions.
  • Tree testing: Evaluates whether users can find content within a proposed structure, using a text-only outline of the site or app.
  • Heatmaps: Show where users click, scroll, and direct attention, helping identify which content is visible and which is being skipped.
  • Analysis of reviews, questions, and comments: Often the fastest source of research. The language users use to describe their problems is free, candid data about what your content is and isn't communicating.

The Editing Process

Good content goes through several distinct editing phases, not just one pass:

  1. Purposeful: Does the content meet user goals, organizational goals, and protective goals? At this stage it's okay for the text to be long.
  2. Concise: Strip the text down to its core meaning. Remove adjectives, adverbs, and filler. Experiment with different structures and word orders to find what's briefest and easiest to understand.
  3. Conversational: After cutting, restore any warmth or naturalness that was lost. Content should not feel sterile or robotic.
  4. Clear: Verify that the meaning will be unambiguous to the person using the experience, especially someone unfamiliar with the product or domain.

One useful editing technique: try starting the same sentence or heading in several different ways (with the imperative verb, with the user's purpose, with context, with an emotional motivator) and compare which version is shortest, clearest, and most aligned with the product's voice.

Pluribus Expectations

Design content as part of the product, not as decoration. Write clearly, test early, and iterate often. When in doubt, read your content aloud. If it sounds like something a knowledgeable, respectful person would actually say, you're on the right track.

Additional Resources


results matching ""

    No results matching ""