How we write
These guidelines help us to make it as easy as possible for people to complete tasks, get information and engage with us on their terms.
Create less content
Consider whether you need to create more content. Content is expensive to maintain and has an environmental impact. The average web page tested produces 1.76g of carbon dioxide for each page view, according to the Website Carbon Calculator.
Outdated, inaccurate content leads people to distrust us and could stop them from buying our products and services. Delete content that people do not need or that evidence shows they are not interested in.
Edit your content
Our audience is mostly on mobile devices, is time-poor and has something they need to do or know.
Get the message across quickly otherwise they’ll be frustrated and go elsewhere. Edit, then edit again to pack maximum meaning into minimal content.
Give information only when it’s needed
People rarely take in information if they’re given it at a point where they cannot act on it. Understand each step they go through when interacting with us and give people the information they need at the right time.
Help people find what they need
People pay more attention to content that’s near the top of a page. Stating who content is for, and what it will help them achieve early on, makes it easier for people to decide whether to continue.
Reflect the words people use
Research how your audience refers to things by speaking to them, finding relevant forums and using search data. What you find out might not be what we call things internally.
Using familiar words means people can find and make sense of content.
Use plain English
According to the National Literacy Trust, 16.4% of adults in England have very low literacy skills. Other things can affect people’s reading and comprehension. Lots of people have English as a second language. People might be tired or distracted when reading something we have written.
Using clear, simple language makes things easier for everyone to understand and increases the likelihood of them interacting with us.
Make it active and direct
Be direct and use active voice. Make it clear who does what and avoid passive voice.
Send your invoice to the finance manager.
The invoice is sent to the finance manager.
Address people directly
Where possible, address people as ‘you’. Speaking directly to the audience makes it quicker for them to relate to what you’re saying and understand what they need to do.
If someone must do something, make it clear. Words like ‘should’ or ‘could’ add an element of doubt. If something is needed, use ‘must’.
Make content easy to scan
People often skim read, looking for words, headings or links that will help them achieve what they came to do as quickly as possible.
Design content so that it’s easy to scan by using:
- short sentences and paragraphs
- subheadings and lists to break up walls of text
- the words your audience use
Use clear titles and subheadings
Headings should be short, precise and reflect the task or information. This helps people decide whether to keep reading.
Book an appointment
Buy a funeral plan
Make it consistent
Choose what you're going to call things and stick to it. Calling the same thing by different names can confuse people.
For example, at Co-op we use ‘sign in’ and not ‘log in’. If we used both terms, then people might think they were different things.
Tell people where they are in a process
People should know where they are and what is going on throughout their journey. Set expectations and give next steps. This builds confidence and creates trust in the service.
Do not tell people how they should feel
Avoid words like ‘quick’, ‘easy’, ‘simple’ and ‘convenient’. We do not know whether that is true for the reader and we should not make assumptions.
Reflect how people understand things
We often have detailed knowledge of the subject we are writing about. Our audience may not.
Design content to reflect how people understand things by:
- answering their questions
- using the words they use
- being clear about what they need to do next
Use abbreviations, acronyms and initialisms with caution
Not everyone will understand what these mean.
Do not use images to replace text content
If you need an image to help people understand something, always include a text description. This is so that people who cannot see the image understand the information.
Do not use time to set expectations
Telling people that something ‘takes 10 minutes to complete’ is misleading and insensitive to people who might take longer.
Use a less subjective description, such as ‘this survey has 10 multiple choice questions’.
Only ask for the information you need
Only ask for personal details if it’s essential. This is the law.
Make decisions with evidence
Test your content
Test that your content works by:
- speaking to your audience
- using analytics
- reviewing it with colleagues
Use the findings from testing and research to keep reviewing content and make decisions about what to publish and what to delete.
Changelog for this page
|17 Sept 2021||First version of page published|