Managing articles

Writing for the web

Why is writing for the web important?

We tend to scan text on a web page - we don't read every word: reading from a computer screen is about 25% slower than reading from paper.

The guidelines below will help you write suitable web copy.

A web page can be a disorientating place to visit

Users may arrive at your page from multiple starting points:

  • A direct link in an email
  • A search result
  • Browsing the navigation
  • A link from another page on the site

Regardless of how they arrive, users need context.

When writing your page make sure these questions are answered for your target visitors:

  • Who is this page for?
    The intended audience of your page must be clear. For those not in the intended audience, is there another page you can direct them to?
  • Is the user in the right place? What will this page allow them to do?
    Make sure the key points / aims of your page are covered in the title and first paragraph. Think about the trigger for a user visiting the page. What would have sent them here? Make sure the user has all the information to complete their task(s)
  • What should the user do if they need help?
    Provide easy access to contact details and/or help materials
  • What should the user do next?
    If this page is part of a process or wider journey, make sure your page links to related pages or documentation

Language and Structure

Make it short

Make sentences short and easy to read. Instead of "It is strongly advised that you seek independent advice on these important matters," use "Seek independent advice".

Use clear and simple language

  • Avoid slang or jargon
    Ask people outside of your organisation to read your text. Is it still understandable?
  • Use shorter words where possible
    For example, use 'next to' instead of 'adjacent to'
  • Use active instead of passive words
    ‘The team won the award’ is better than, ‘The award was won by the team’

Limit each paragraph to one idea

Assign one idea to each paragraph so visitors can easily scan a paragraph then move onto the next.

Front-load paragraphs

Front-loading means putting the conclusion first, followed by the what, how, where, when and why. 
The first line of each paragraph should contain the conclusion for that paragraph, so readers can:

  • Quickly scan through the opening sentence
  • Instantly understand what the paragraph is about
  • Decide if they want to read the rest of the paragraph or not 

Formatting

Use descriptive subheadings

Break up paragraphs of text with descriptive subheadings. This allows users to easily scan the page to find what they're looking for.  Using subheadings will also force you to group the content logically.

Important words in bold, not underlined

Use bold to highlight important words.

Don't underline words as it makes them look like links.

Use descriptive link text

Link text stands out on screen and helps users scan for keywords. Avoid "click here" or "learn more". Phrases like this don't tell readers where the link will take them. You're forcing them to stop scanning and read around the link in order to get context.  

Read more about why writing good link text is important.

Use lists

Bulleted and numbered lists are:

  • Easier to scan than paragraphs
  • Less intimidating
  • Usually more succinct

Call to action

What should users do next? Always try to provide a link to further information. This could be a form, additional guidance, a contact name, or another related page on the site.

Get your Content Online

Want to get your well-written content onto your intranet?
Find out more about adding content to your site:

Creating content