Last reviewed: 17 Sept 2021

Content guidelines

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.

Be relevant

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.

Be clear

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.

Example

Good example:

Send your invoice to the finance manager.

Bad example:

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.

Remove ambiguity

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.

Examples

Good examples:

Book an appointment

Buy a funeral plan

Bad examples:

More information

Further help

Go to the guidelines on headings, paragraphs and lists.

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.

Be considerate

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

Be inclusive

Use abbreviations, acronyms and initialisms with caution

Not everyone will understand what these mean.

Go to the guidelines on abbreviations, acronyms and initialisms.

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.

Go to the accessibility standard on text alternatives.

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.

Go to the Information Commissioner’s Office guidance on the General Data Protection Regulation.

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

Date Notes
17 Sept 2021 First version of page published

Get support

Co-op Digital colleagues can get support in our dedicated Slack channel:

#experience-library-support

Sign up for email updates

Get updates about changes and developments.

Sign up

Copyright © Co-operative Group Limited. All rights reserved.