Content Best Practices

General Guidelines

Keep it simple

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/more conversational tone for the web. Help users quickly digest the page’s content with the following approach:

  • 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, fast!

While there is certainly a place for flowery or expositional writing, the purpose of the 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: 40-70 words; can be as little as two sentences
  • Page: 300-700 total word count
  • 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.

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?

A simple way to gain insight into your audience’s needs is to check your web analytics.

  • What search terms are people using to reach this page?
  • How frequently is a page being visited? If page visits are low, is the page needed? Should it be consolidated with another page?
Calls to Action

Your website is built to influence certain behaviors and actions. Calls to action (CTA) help encourage these behaviors and provide a next step. Effective CTAs use strong verbs and compelling language. CTAs are not required in all cases, but every page should at a minimum have a purpose. Vague language like “learn more” or “click here” are not ideal since they do not provide a specific enough description to the content that is being linked.

Examples of specific, descriptive CTAs:

  • Fill out a form to request more information.
  • Submit your application.
  • Contact the Dean.
  • Reserve your seat.
  • Attend our open house.
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 a quote row to break up the text and emphasize key theme.
    • Add an alumni quote row to add interest to an academic program.
    • Make use of number fact rows to emphasize key statistics that might be harder to digest in written form.

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.
    • 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.”
  • Max of 8-10 words.
    • Example: “Types of Financial Aid”
  • Should make sense out of context.
    • Example: “Happening in Human Resources” is preferred vs. simply “Events”
Search Engine Optimization (SEO)

Search Engine Optimization (SEO) refers to maximizing visibility in organic search engine results. SEO includes a blend of technical, content, and creative strategies and techniques. This style guide focuses on on-page SEO, which includes best practices that should be made at the level of individual pages. (as opposed to off-page SEO, which deals with improving external links to your site).

Metadata

Metadata is information that goes in the HTML markup to provide search engines with key information about the page content. The two most important metadata tags for SEO are title tags and meta descriptions.

Title Tags

The page title tag is a meta element that should clearly communicate the purpose of the page. Title tags (also called “meta titles”) are the page components that search engines and other web technologies use to identify the page. Title tags are displayed on search engine results pages as the clickable headline for a given result, and are important for usability, SEO, and social sharing.

The new website will follow the same title tag format across all entry points:

  • “Page Title” – Johns Hopkins Human Resources

Examples:

  • About – Johns Hopkins Human Resources

Best practices for writing title tags:

  • Make sure every page has a unique title.
  • Not be laden with loosely related keywords.
  • Follow a consistent naming convention for like pages.
  • Not exceed 60-75 characters. Exception: in some cases it is acceptable for title tags to exceed 60 characters; for example, when the name of the site after the page title is significantly long.

The name you give to a page becomes part of the Title Tag

“Name of Entry Point” is automatically appended to the page name creating the complete page title.

Meta Descriptions

Meta descriptions should be short, clear descriptions of the content on that page. Meta descriptions help search engines understand what the page is about, and they also provide the text summary that appears on SERPs.

Best practices for writing meta descriptions:

  • Aim for 160 characters maximum.
  • Write for human users, not for search engines.
  • Accurately describe the content on the page.
  • Try to work in keywords organically, but avoid keyword stuffing.
  • Make sure every page has a unique meta description.

Note that Google will sometimes replace your meta description on a SERP with other content it finds on the page that it feels is more useful for users. This occurs when descriptions are too long, if they don’t describe the page, and if there is unnatural use of keywords.

The meta description for a page can be added or edited using the Yoast SEO plugin that appears near the bottom of the page. First click on “Edit Snippet”

Then enter or edit the Meta description.

Headings

Descriptive, structured headings help tell search engines what the page contains. Follow a logical hierarchy when structuring page content, and avoid skipping heading levels. Headings are a good place to include keywords when it’s natural; avoid forcing or overusing keywords just for SEO value.

Guidelines to consider when writing headings:

  • Headings should be succinct, descriptive phrases in Title Case with no ending punctuation.
  • Use keywords at the beginning of headings vs. at the end.
    • 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.”
  • Max of 8-10 words.
  • Use concise and descriptive language.
    • Example: “Types of Financial Aid”
  • Should make sense out of context.
    • Example: “Happening in Human Resources” is preferred vs. simply “Events”

To create a heading, select the desired text and choose the appropriate heading level in the page editor:

Descriptive Links

Always use descriptive labels (never “click here”). Write clear, concise and direct links that describe the content of the page being linked to. Links are a good place to include keywords when it’s natural; avoid forcing or overusing keywords just for SEO value.

Best practices for writing links:

  • Describe the link in as much detail as possible to create the most clear description of the content being linked to.
  • Links that open PDFs should be clearly marked. Ex: Viewbook (PDF).
  • Avoid generic navigational labels such as Resources, Services, and Information, which do not provide a clear description for audiences on the content that would be found there. Instead, opt for descriptive terms such as “Educator Resources” or “Student Services”.
  • Order is important! If there are a long list of items, alphabetical is usually best. However, it often makes sense to order links in the order a site visitor needs to complete tasks. Attention will be paid to the items that appear at the top.
  • Always verify links. Broken links prevent search engines from finding all the information they need when crawling the site.

PDFs

Try to limit the use of PDFs and other file uploads in favor of actual web content. Content within PDFs, Microsoft Word documents and other files tends to be weighted lower than content on web pages by search engines. Whenever possible, make information contained in PDFs and other files web content instead.

Keywords

Strategically using keywords can help improve search engine rankings. However, search engines now focus on perceived user intent over simply just use of keywords. There is an increased importance of comprehensive messages including related keywords throughout a given page. When writing new content, consider that many users now use voice search to find information. Consider how users ask questions and let the content answer those questions.

Note on the SEO-Accessibility Connection

The next section will discuss accessibility best practices. Screen readers and search engines rely on the same structure and information to make sense of content and functionality. If you follow best practices for accessibility, you will also improve your site’s search engine optimization (SEO).