Web Writing Best Practices
Are you writing or revising content for an SDSU College of Education website? Fabulous. You’re in the right place. Use the following guidelines, tips and (not-so-subtle) suggestions to create more effective content, engage and inform your audiences, and meet your goals.
6 Quick Tips
1. Write clear, simple and effective content
- Content should be written in an east-to-read, conversational style
- Always keep your audience, messages, personality and goals in mind
2. Put the most important content in the first paragraph
- Readers scan pages, you don't want them to miss your main idea
3. Chunk your content
- Cover only one topic per paragraph
4. Be concise
- Write short paragraphs and minimize unnecessary words
- Sentence structure should be simple and varied
5. Use active voice instead of passive voice
- Yes: The professors taught the class.
- No: The class was taught by the professor.
6. Choose lists over long paragraphs
- Use lists to make your content easier to scan
Write Meaningful Headers
Headers allow readers to navigate content. Use the header to clearly describe the content in each paragraph.
- Be short and direct
- Be able to stand on their own and understood out of context
- Avoid jargon, abbreviations, cleverness and technical terms
- Be search engine friendly - see "SEO Writing" below
Use Common Language
For SEO (Search Engine Optimization) use the same words and phrases your readers do. When creating page titles, headers, list items and links, choose keywords carefully and use them consistently. This practice reinforces the relevancy of these keywords for search engines.
Readers expect a personal, upbeat tone in web writing. They find bureaucratic writing offensive and out-of-place and ignore the message it's trying to convey.
To avoid bureaucratic language, turn the tone down a notch. Search out and destroy jargon. Use active voice. Always try to write in first or second person.
Keep it Short
Web writing needs to be much shorter than other kinds of writing. Research shows that people scan web text, rather than reading every word. Make it easy for your users to scan for information quickly. A paragraph should consist of 70 words or less.
Writing for the web is not the same as writing for a print publication. A page on the web should be half the length of a similar print document.
300-700 words is a reasonable average length for any web content.
What if you have more than 700 words? Break your content into sections, leading readers to specific portions of the text as much as possible. It’s your job as a web author to guide your audience to the content you want them to consume.
Don’t waste space welcoming people to your page. There is no need – most users ignore welcome text as filler. Get to the meat – that’s what they came for.
Subheadlines, Lists and Scanning
On average, users read about 20 percent of your content per page.
Oh no! What should you do? Be concise. Be relevant. Use short sentences and action verbs, and cut inessential text without sacrificing your identity.
Along with short, easy-to-read blocks of text, you also should make good use of lists and subheadlines. These elements help guide readers' eyes toward the most important content, and make it easier to absorb large content.
Use a bulleted list to break up content. Write a short sentence and then support it with bullet points.
Use Links Effectively
Link, link and link to relevant information.
If you mention the College's L4L program, link to it. If you want to include someone’s email address, link their name. If you mention a faculty member, link to their bio page.
Don’t make people go and search for something you mention if it already has a page somewhere.
The average time new visitors spend on any one page is around 30 seconds. Take advantage of that short attention span by providing lots of relevant links to explore.
Do not use the phrase "click here" for links. Why? Just like sighted users scan a page for linked text, visually-impaired users can use their screen readers to scan for links. As a result, screen reader users often do not read the link within the context of the rest of the page. Using descriptive text properly explains the context of links to the screen reader user.
Additionally, search engines read the web much like screen readers do, so creating targeted and relevant link text will improve the overall SEO (Search Engine Optimization) of our website. No one ever searches for the term "Click Here" in a search engine!
Research shows that users like them to be 4-8 words in length.
- Yes: For more information, view the Child Development major.
- No: To find out more about the Child Development major at the college, click here.
Keep it simple. Don't underline or use bold, italics, headings and indentations excessively. They may be difficult to read from the users' view and lose their power if used frequently. Do not write in all caps!
Structure Your Content Like an "Inverted Pyramid" on Top-Level Pages
What’s an inverted pyramid? It’s a writing style where you put your most important information first.
Load the most important information at the top of the page and at the top level of your site. Often this is a few sentences or bullet points.
Content that requires users to scroll vertically loses up to 80 percent of its readership.
Your introductory sentences or paragraphs for any key landing pages are prime real estate for your messages.
The goal is to capture the interest of site visitors. Save the more specialized and lengthy pages for deeper levels of the site.
Search Engine Optimized (SEO) Writing
Most users visit a web page for 10-15 seconds. In that brief time, 80 percent will skim the page for keywords they already have in mind. Therefore, before you write or revise content, it’s important to understand your audience and anticipate what content and keywords they’re trying to find.
When a user conducts a search on the search engine, the database is queried to identify all the pages that include those words on the page and/or in the links pointing to that page. If your page does not include the words the user was searching for, it is unlikely that your page will rank well, if at all.
The same is true when none of the links to that page include the words that the user used in their search.
Once pages have been identified, search engines order the results according to relevance. Relevance can be determined based on dozens and dozens of criteria, such as keyword prominence (how often your keywords appear on a page and where they appear).
Keep Your Content Fresh
Outdated web content will confuse your users and make you look lazy. It also degrades the user's trust in your information.
Add fresh content (text, images, video) as often as possible. Make sure your staff and contact information is up-to-date and remove past events from your site.
If you use a header image, make sure it's relevant to your subject matter. Choose an image that is compelling, vibrant and cropped appropriately.
The contents of this page have been reproduced with the permission of UW College of Education.