Writing for the web
Write with your audience in mind
Always consider who is reading and why.
- Ask, “What problem is the reader trying to solve?”
- Focus on helping the reader solve that problem
- Be factual, clear and service-oriented
- Avoid being overly formal or promotional
- Remove content that doesn’t serve the reader’s needs
Write for scanning, not for reading
Most people skim webpages rather than reading every word.
- Use short paragraphs of one to three sentences
- Break up your text with clear and descriptive headings and subheadings
- Use numbered or bulleted lists where possible
Lead with what matters most
Web readers want to find the information they’re looking for as quickly as they can.
- Start pages with the key takeaway
- Use the inverted pyramid: essential information first and details later
- Avoid long introductions or providing too much background
Use meaningful headings
Headings help users scan content quickly.
- Use descriptive headings and avoid being clever, metaphorical or promotional
- Use headings that summarize the information that follows
Use accessible language
Write for a general audience rather than specialists.
- Write for a grade level of 10 or lower*
- Choose simple and familiar words
- Avoid jargon and acronyms
- Aim for 20 words or fewer per sentence
- Remove unnecessary words and repetitions
- Be professional but conversational
* You can find a document’s grade level in Microsoft Word under the Home tab. Click Editor and then select Insights/Document Stats. A pop-up window will show your document’s Flesch-Kincaid Grade Level along with other readability statistics.
Write clear, action-oriented links
Links should tell users exactly what will happen when they click.
- Avoid vague links like “click here” or “learn more”
- Use descriptive link text similar to this example: Visit Memorial’s T4 User Guide for more resources.
Be inclusive and accessible
Content is for everyone.
- Use inclusive language that avoids assumptions about gender, ability or background
- Write concise and clear alt text for images
- Use plain language to support screen readers and translation tools
Review and edit before publishing
The best web content is revised content.
- Read your text out loud before publishing to catch awkward phrasing
- Check spelling, grammar and links
- Ensure names, dates and policies are up to date
- Trim anything that doesn’t add value
Keep content up to date
Outdated content undermines trust.
- Set a schedule (and reminders) to review your pages regularly*
- Remove expired deadlines, events or references
- Flag content that requires an update
*You can learn how to set content reminders in our T4 User Guide.