General Guidelines

Best Practices

To communicate effectively online, always strive to write as clearly and concisely as possible. Remember that website users only read 20-28% of copy on the page. Tips for creating copy that is easy to scan include:

  • Put the most important information “above the fold” of the page.
  • Break up large “walls” of text into chunks of copy with multiple headlines.
  • Avoid duplicate information on a page, even when you are saying the same thing in two different ways.

Use plain language and active voice.

  • Use a less formal and more conversational tone for the web.
  • Use a 10th grade reading level. Tools for checking readability include Microsoft Word’s built-in tool and a Readability Test Tool.
  • Avoid jargon. If introducing internal language, provide context and/or define its meaning in the copy or via link.

Get to the point, quickly.

While there is certainly a place for flowery or expositional writing, the purpose of a website is primarily to inform. The more quickly this is achieved, the better the user’s experience. Follow these guidelines for length of content:

  • Sentence: No more than 15-20 words.
  • Paragraph: Can be as little as two sentences, but should be no more than five. The ideal length is 40-70 words.
  • Page: Should contain a word count of 300-700. The ideal maximum length is 500 words.
  • Headings: Should not exceed 8-10 words.
Audience-Centered Writing

Website content should always be relevant and appropriate for the intended audience. The website serves a wide and diverse community of internal and external audiences. While the website has multiple audiences, content does not have to, and should not, attempt to speak to each audience. When writing content, consider the primary users who will be reading that particular page.

Be careful to avoid using internal jargon for audiences not familiar with it.

Avoid writer-centered content when choosing what to include, and how to say it.

Keep the audience in mind by asking:

  • What information are people looking for on this page?
  • What questions do they have?
  • What problems can you help them solve?
  • Is the content appropriate for the audience’s reading level?
  • What page(s) might they visit next? Is the path clear?
Content Length Guidelines

The following are commonly accepted length guidelines:

  • Sentence: Should be no more than 15-20 words.
  • Paragraph: Can be as little as 2 sentences, but should be no more than five. Ideal length: 40-70 words.
  • Page: Should contain a word count of 300-700. Ideal maximum length: 500 words.
  • Headings: Should not exceed 8-10 words.

Exceptions: Pages where the user requires informational content.

  • For example, a curriculum overview with all required coursework for a graduate program. This might be organized in tabs or expandable content components, but it is necessary to help the user achieve their goals.
Readability & Plain Language

Making content readable is an important aspect of the user experience.

  • Use a 10th grade reading level as the gauge for readability.
  • Write in plain language. Readability is key.
  • If introducing unique language, provide context and if necessary, define.
  • Long sentences and advanced vocabulary slow readers down. Plain language communicates information more efficiently.

Tools to check readability:

Scannability & Headings

Scannability refers to helping users find what they are looking for by organizing content into manageable “chunks.”

Tips for making content scannable:

  • Use clear headings that help define the content and guide users through the page as they scroll.
  • Consider if you can split a “wall of text” into themes with multiple headings?
  • Put the most important information “above the fold” on a page.
  • When necessary to use long-form content, follow the inverted pyramid style, leading with key information.
  • Incorporate visual aids such as photos or videos to help communicate your message and engage the reader.
  • Use the new website components that are available to you.
    • Include an Accordion if you need to break up long text into a series of categories
    • Use a Tab component to break up content into sections.

Tips for writing effective headings:

  • Headings should be succinct, descriptive phrases in Title Case with no ending punctuation.
  • Use keywords at the beginning of headings versus at the end. For example, if your keywords are “progressive education curriculum,” the preferred heading would be “Progressive Education Curriculum Overview” vs. “What You Need to Know About the Progressive Education Curriculum.”
  • Use a max of 8-10 words.
SHWB Style Guide

This section is a guide to the “house style” of the Office of Student Health and Well-Being, intended for SHWB staffers who update the site. If you have any suggestions, questions, or additions, email [email protected].

Every single image uploaded to any media library should include alt text, so site users who use assistive technology can access the information in the image. That includes infographics, illustrations, and posters, in addition to photographs. It’s something that all website managers should do, and it’s particularly important for SHWB because our office includes Student Disability Services. (It’s also an ADA mandate.)

Every single PDF uploaded to any media library should be an accessible PDF, so site users who use assistive technology can access the information in the file. Adobe has a good how-to page on what an accessible PDF is and how to create one in Adobe Acrobat.

If you are using any kind of Heading formatting, do not put a colon (:) after the Heading. The formatting sets it off from the rest of the text; you don’t need the punctuation as well.

If you create a list, make it a bulleted or numbered list. It looks better, and it is more accessible for people using screen readers.

An incorrect example:

First item on list
Second item on list
Third item on list

A correct example

  • First item on list
  • Second item on list
  • Third item on list