We're creating a new front-end 'Experience Kit'
For more information go to the #Experience-library-support Slack channel (Co-op colleagues only).
Content guidelines
How we write
Good content helps people to complete tasks, find information and interact with us in ways that suit them.
Create smarter content, not more content
Think about whether you need to create more content. Too much content can be overwhelming for people and get in the way of what they need to do.
Content is expensive to maintain. Creating and storing content also demands energy, which has an environmental impact.
Before creating content, ask yourself:
- does the content exist elsewhere, and could you make it easier to find?
- is the content meeting a user need?
- would people be able to complete their task without the content?
Edit your content
People who use our products and services are mostly on mobile devices. They do not have much time, and have something they need to do or know.
Get the message across quickly so that they do not get frustrated and go elsewhere.
Edit, then edit again to create content that is short and easy to understand.
Delete content that is no longer useful
Delete content that:
- is out of date
- is not accurate
- does not meet a user need
- people are not interested in, based on evidence
Outdated, inaccurate content might make people lose trust in us and not use our products and services.
Be relevant
Help people find what they need
People are more likely to take in information if they’re given it at a point where they can act on it. Understand each step our users go through when interacting with us.
Include the most important information at the start – what the purpose of the page is, and who it’s for. This helps people know whether they’re in the right place.
Put content in a logical order
For people to understand content, it needs to follow a logical order and have a clear relationship with other content.
Keep pages as simple as possible and make sure they make sense when read top to bottom.
Use clear headings and sub-headings to give your content a logical structure.
Find out more about how structure affects accessibility.
Use the words that your audience use
Your audience may not use the same words that we use at work. Work with user researchers to understand the words your audience use.
Using the words your audience use helps people to find and understand content.
Be clear
Use clear English
Write in short words and sentences. This helps people that:- have low literacy levels
- do not have English as their first language
- are tired or distracted
- have a disability or impairment
Make it active and direct
Be direct and use active voice to make it clear who does what. Avoid passive voice.
Active voice:
Fill in the form.
Passive voice:
The form should be filled in.
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 any unnecessary doubt
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 scan content, looking for words, headings or links that will help them achieve what they came to do as quickly as possible.
Write content so that it’s easy to read quickly by using:
- short sentences and paragraphs
- subheadings and lists to break up walls of text
- clear English
Use clear titles and subheadings
Headings should be short and describe the task or information. This helps people decide whether to keep reading. Avoid the temptation to use headings to attract attention and sound exciting. They should always reflect what the content that follows is about.
Good examples:
Book an appointment
Buy a funeral plan
Bad examples:
More information
Further help
Go to the guidelines on headings, paragraphs and lists.
Use the same words for the same things
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.
Explain things clearly
We must never assume that our users understand our way of doing things, our business language or our products and services. Clear, simple content that explains what they need to do will help them achieve their task, which is good for them and good for our business.
Simplify content by:
- explaining what people need to do
- removing information that is not needed
- answering questions people had during research
- being clear about what people need to do next
Legal content in particular can be hard work to explain, but is important to get right. The more clearly we can explain something, the more likely they are to use our services. Being understood is more important than sounding clever.
Bad example:
Check if you need probate
1 in 2 people will need it. If you need probate and instruct Co-op Legal Services, you might not need to pay for the funeral upfront, as we can take payment directly from the estate.
Good example:
Check if you need probate
1 in 2 people will need probate. This is the legal process of dealing with someone's home, money and possessions after they have died. You will only need probate if the person who died:
- owned a house in their sole name
- had more than £30,000 in the bank
If you instruct Co-op Legal Services, you might not need to pay for the funeral upfront, as we can take payment directly from the estate.
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 rely on assistive technology, like screen readers, can access 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
This is the law.
Go to the Information Commissioner’s Office guidance on the General Data Protection Regulation (UK GDPR).
Make decisions with evidence
Research with users to help make content decisions
Hearing from the people who'll be reading your content is one of the best ways to know if your content works or not. User research can identify issues, or let you know if it's ready to be published.
Show the content to users through virtual or in-person research. Notice what they struggle understanding. Use these findings to make improvements to your content.
Changelog for this page
Date | Notes |
---|---|
4 Oct 2024 | Content made simpler and examples added |
17 Sept 2021 | First version of page published |