v1.1.0
  1. Foundations
  2. How-tos
    1. Build digital spaces
    2. Writing for users
  3. Patterns

Writing for users

Write clear, direct content that helps users find and understand information quickly.

Write like you're talking to a friend.

The basics

Understand your audience's behavior

Think in their language and vocabulary.

Stay curious about their questions and how they phrase them.

Listen to how library users describe things and what words they use.

Write like you talk

Think about how you would respond to someone calling you on the phone or in person.

Respond authentically.

Use pronouns when talking to your reader. Say "we" or "us" instead of "the library."

Organize and order your content

Choose the best way to organize your content. Consider what you're working with and how your audience will approach the information.

  • Organize by time or sequence
  • Group by audience
  • Sort by task
  • List alphabetically
  • Order by how people ask questions

Use the inverted pyramid. Start with your primary message, then add what users need to know, and finally what's nice to know.

Break it up by headings

Use headings to help users scan and find what they need. Make them meaningful, succinct, and unambiguous.

Go for short and simple

Break up text with short paragraphs. Present one concept or chunk per paragraph.

Consider layering

Present your content at the point of need, rather than sharing it all at once. Guide users through a path to more information.

Keep your sentences short.

Choose simpler words when you can.

Use active voice

In active sentences, there is a clear subject doing an action.

Before After
Library patrons must sign into their library account to renew books. Sign in to your library account to renew books.
Catalog search relevance is continually being improved. We're improving search results to make them more relevant.
Interlibrary Loan Request Form. Request an item.

Use parallel structure

Use parallel grammatical structure in lists, headings, menus, and sentences. Our brains like patterns.

Write clear link labels

Place link labels on menus, buttons, navigation elements, and in body text.

Make your link labels meaningful and unambiguous. Users should know where they'll end up when they select a link.

This is especially important for visually impaired users who navigate with screen readers and may skip through the page reading links.

Avoid phrases like "click here" or "more" that become meaningless out of context.

Style your links

Underline your links. This is the long-standing convention and best for usability and accessibility.

Don't rely solely on hover as an indicator.

Align your text

Left-justify your text and let it rag right.

Avoid justified text. It creates inconsistent spacing between words and makes reading harder.

Don't center text. It's hard on the eyes when the next line starts in a different place.

Format for emphasis

Draw attention to content by structuring with headings or using bold for keywords.

Avoid italics in large sections. Use bold for emphasis instead.

Use proper capitalization

Don't use ALL CAPS. It hurts your voice and tone, and it's hard to read because all letters are the same height.

Use capitalization intentionally and meaningfully.

Choose sentence case over title case. It's easier to read.

Use semantic headings

Use proper semantic headings in your web content (h1 for Heading 1, h2 for Heading 2).

This is especially important for screen reader users, but the clear structure helps everyone.

Don't skip heading levels or use them just for formatting.

Write alternative text

Write alt text that provides a text equivalent to audio and visual content.

Make your alt text approximate the purpose of the image in context.

Keep your alt text accurate, equivalent, and succinct.

Design System

About Writing for users Build digital spaces v1.1.0