Writing for GOV.UK
How to write well for your audience, including specialists.
Writing well for the web
People read differently on the web than they do on paper. This means that the best approach when writing for the web is different from writing for print.
Our guidance on writing for GOV.UK is based on research into how people read online and how people use GOV.UK. It explains what each rule is based on.
When you write for GOV.UK you should:
- use writing for the web best practice
- follow the Government Digital Service (GDS) style guide and writing guidance
Meet the user need
Don’t publish everything you can online. Publish only what someone needs to know so they can complete their task. Nothing more.
People don’t usually read text unless they want information. When you write for the web, start with the same question every time: what does the user want to know?
Meeting that need means being:
- clear and to the point
Finding information on the web
An individual’s process of finding and absorbing information on the web should follow these steps.
I have a question
I can find the page with the answer easily – I can see it’s the right page from the search results listing
I have understood the information
I have my answer
I trust the information
I know what to do next/my fears are allayed/I don’t need anything else
A website only works if people can find what they need quickly, complete their task and leave without having to think about it too much.
Good content is easy to read
Good online content is easy to read and understand.
- short sentences
- sub-headed sections
- simple vocabulary
This helps people find what they need quickly and absorb it effortlessly.
The main purpose of GOV.UK is to provide information - there’s no excuse for putting unnecessarily complicated writing in the way of people’s understanding.
Writing well for specialists
Government experts often say that because they’re writing technical or complex content for a specialist audience, they don’t need to use plain English. This is wrong.
Research shows that higher literacy people prefer plain English because it allows them to understand the information as quickly as possible.
For example, research into use of specialist legal language in legal documents found:
- 80% of people preferred sentences written in clear English - and the more complex the issue, the greater that preference (eg, 97% preferred ‘among other things’ over the Latin ‘inter alia’)
- the more educated the person and the more specialist their knowledge, the greater their preference for plain English
People understand complex specialist language, but don’t want to read it if there’s an alternative. This is because people with the highest literacy levels and the greatest expertise tend to have the most to read. They don’t have time to pore through reams of dry, complicated prose.
Where you need to use technical terms, you can. They’re not jargon. You just need to explain what they mean the first time you use them.
Legal content can still be written in plain English. It’s important that users understand content and that we present complicated information simply.
If you have to publish legal jargon, it will be a publication so you’ll be writing a plain English summary.
Where evidence shows there’s a clear user need for including a legal term, eg ‘bona vacantia’, always explain it in plain English.
If you’re talking about a legal requirement, use ‘must’. For example, ‘your employer must pay you the National Minimum Wage (NMW)’.
If you feel that ‘must’ doesn’t have enough emphasis, then use ‘legal requirement’, ‘legally entitled’ etc. For example: ‘Once your child is registered at school, you’re legally responsible for making sure they attend regularly’.
When deciding whether to use ‘must’ or ‘legally entitled’ etc, consider how important it is for us to talk about the legal aspect, as well as the overall tone of voice.
If a requirement is legal, but administrative, or part of a process that won’t have criminal repercussions, then use: ‘need to’. For example: ‘You will need to provide copies of your marriage certificate’.
This may be a legal requirement, but not completing it would just stop the person from moving on to the next stage of a process, rather than committing a more serious offence.
Footnotes and legal language
Don’t use footnotes on documents. They’re designed for reference in print, not web pages. Always consider the user need first. If the information in the footnotes is important, include it in the body text. If it’s not, leave it out.
Know your audience
Your writing will be most effective if you understand who you’re writing for.
To understand your audience you should know:
- how they behave, what they’re interested in or worried about - so your writing will catch their attention and answer their questions
- their vocabulary - so that you can use the same terms and phrases they’ll use to search for content
When you have more than one audience, make your writing as easy to read as possible so it’s accessible to everyone.
The GOV.UK audience
The GOV.UK audience is potentially anyone living in the UK who needs information about their government, or people abroad who want to do business in or travel to the UK. This means government must communicate in a way that most people understand.
The best way to do this is by using common words and working with natural reading behaviour.
If you’re writing for a specialist audience, you still need to make sure everyone can understand what the content is about.
How people read
Knowing how people read means you’ll write in a way they can understand easily and quickly - so you don’t waste their time.
All of this guidance is based on the learning skills of an average person in the UK, who speaks English as their first language. This guidance also applies when you’re writing for specialists.
By the time a child is 5 or 6 years old, they’ll use 2,500 to 5,000 common words. Adults still find these words easier to recognise and understand than words they’ve learned since.
By age 9, you’re building up your ‘common words’ vocabulary. Your primary set is around 5,000 words; your secondary set is around 10,000 words. You use these words every day.
Use short words instead of long words
When you use a longer word (8 or 9 letters), users are more likely to skip shorter words (3, 4 or 5 letters) that follow it. So if you use longer, more complicated words, readers will skip more. Keep it simple.
“The recently implemented categorical standardisation procedure on waste oil should not be applied before 1 January 2015.”
The ‘not’ is far more obvious in this:
“Do not use the new waste oil standards before 1 January 2015.”
Children quickly learn to read common words (the 5000 words they use most). They then stop reading these words and start recognising their shape. This allows people to read much faster. Children already read like this by the time they’re 9 years old.
People also don’t read one word at a time. They bounce around - especially online. They anticipate words and fill them in.
Your brain can drop up to 30% of the text and still understand. Your vocabulary will grow but this reading skill stays with you as an adult. You don’t need to read every word to understand what is written.
This is why we tell people to write on GOV.UK for a 9 year old reading age.
Explaining the unusual
We explain all unusual terms on GOV.UK. This is because you can understand 6-letter words as easily as 2-letter words – if they’re in context. If the context is right, you can read a short word faster than a single letter.
By giving full information and using common words, we’re helping people speed up their reading and understand information in the fastest possible way.
People with some learning disabilities read letter for letter - they don’t bounce around like other users. They also can’t fully understand a sentence if it’s too long.
People with moderate learning disabilities can understand sentences of 5 to 8 words without difficulty. By using common words we can help all users understand sentences of around 25 words.
Capital letters are harder to read
When you learn to read, you start with a mix of upper and lower case but you don’t start understanding uppercase until you’re around 6 years old.
At first, you may sound out letters, merge sounds, merge letters and so learn the word.
Then you stop reading it.
At that point, you recognise the shape of the word. This speeds up comprehension and speed of reading.
As writers, we don’t want people to read. We want people to recognise the ‘shape’ of the word and understand. It’s a lot faster.
Capital letters are reputed to be 13 to 18% harder for users to read. So we try to avoid them.
Block capitals indicate shouting in common online usage. We are government. We should not be shouting.
Ampersands can be hard to understand
Ampersands are allowed in logos – the pictorial logo at the top of an organisation page – but not in body copy.
The reason is that ‘and’ is easier to read and easier to skim. Some people with lower literacy levels also find ampersands harder to understand. As government, we can’t exclude users in any way.
How users read web pages
Users read very differently online than on paper. They don’t necessarily read top to bottom or even from word to word.
Instead, users only read about 20 to 28% of a web page. Where users just want to complete their task as quickly as possible, they skim even more out of impatience.
Web-user eye-tracking studies show that people tend to ‘read’ a webpage in an ‘F’ shape pattern. They look across the top, then down the side, reading further across when they find what they need.
What this means is: put the the most important information first. So we talk a lot about ‘front-loading’ sub-headings, titles and bullet points.
For example, say ‘Canteen menu’, not ‘What’s on the menu at the canteen today?’
At the activity centre you can:
At the activity centre:
- you can swim
- you can play
- you can run
Titles and summaries
Most people who use GOV.UK start with a search engine. Use the same vocabulary as your audience so they can find your content. This starts with your page title, summary and first paragraph.
If people can’t find your page, they won’t read your content.
How to optimise content
- Find out what the public calls your content by using search tools to look up keywords. Your scheme, organisation or process’s official or internal name may not be what the public calls it.
- Check searches on GOV.UK for any related content . This can tell you what people are struggling to find.
- Once you know the most popular keywords you can prioritise them in the title, summary, introduction and subheadings
This is called search engine optimisation (SEO). Search engines return results based on how closely the content appears to match the person’s search term.
In 2001 Bereavement Allowance replaced Widow’s Pension. Search tools show that many people still look for Widow’s Pension even now, so this was included in the title of the Bereavement Allowance guide on GOV.UK.
Answer the user’s question in the summary
People will easily find well-optimised content. If you have a simple answer to a question, put it in the summary. This means users don’t need to leave Google (or whatever search engine they choose to use) to get their information.
GOV.UK’s goal isn’t ‘high traffic’, it’s ‘the right traffic’.
Most people want to know the cost of a passport before they apply. We’ve put the price in the summary so it shows in the search results.
Think about how the title will look in search on GOV.UK and on search engines.
- Keep all titles to 65 characters or less (including spaces). This is because search engines truncate (cut off) titles in Google search results over that number. Words or parts of words will be cut off. That’s why Whitehall Publisher shows a warning if you go past this limit.
- Make sure your title is unique. It’s not helpful for people if search results show a list of pages with the exact same title. If there are a number of pages with a repeated phrase in the title (eg ‘Import and export regulations for the automotive sector’, ‘Import and export regulations for the chemical sector’) change the title so that the most important area is front-loaded, eg ‘Automotive sector: import and export regulations’ or ‘Chemical sector: import and export regulations’. This is more descriptive and useful for search.
- Titles should be clear and descriptive. The title should provide full context so that people can easily see if they’ve found what they’re looking for, eg ‘Guidance for potato growers’, not ‘Potatoes’.
- Front-load your titles. The most important information and the words the user is mostly likely to have searched should be at the beginning of the search result.
- Make titles active where possible - avoid gerunds and participles eg ‘Submit Statutory Declarations’ not ‘Using and submitting Statutory Declarations’.
- If you need to use a separator to break up long title, use a colon (it helps users to scan). Eg ‘Planning appeal procedures: technical review’ works better than ‘Technical review of planning appeal procedures’.
- Only use an acronym in the title if it is a commonly used search term (like EU).
- Avoid puns or wordplay since these can make the content difficult to find.
Good example: ‘Income Tax reform: impact assessment’
Bad example: ‘An assessment of the impact of proposed reforms to Income Tax’
Along with the title, the summary is usually what users see in search results. Make sure people can see quickly whether this page will have the information they want.
- Keep all summaries to 140 characters (including spaces) as Google only shows 140 characters for the summary. Make sure you cover the main point of the page in the first 140 characters of the summary.
- Summaries must end with a full stop. This is for people who use assistive technology like screen readers.
- Keep summaries active and include a verb.
- Include keywords - especially ones you haven’t included in the page title
- Use plain English (no require, obtain etc)
- Only use acronyms if they are very common, eg EU, NATO.
Structuring your content
There is no minimum or maximum page length for GOV.UK. However:
- people only read 20 to 28% of text on a web page anyway
- remember that the pressure on the brain to understand increases for every 100 words you put on a page
This means that the quicker you get to the point, the greater the chance your target audience will see the information you want them to.
It’s most important that you write well. If you write only a single paragraph but it’s full of caveats, jargon and things users don’t need to know (but you want to say) then it’s still too much.
Writing body copy
Keep your body copy as focused as possible.
Remember that you’re likely to be battling outside factors for people’s attention, not least their mood and situation. They might be looking on a mobile on a train, trying to complete their task online in the middle of a stressful family event or any combination of multiple unknowns. If you want their attention, don’t waste their time.
- Don’t repeat the summary in the first paragraph.
- Use the ‘inverted pyramid’ approach with the most important information at the top tapering down to lesser detail.
- Break up text with descriptive subheadings. The text should still make sense with the subheadings removed.
- Paragraphs should have no more than 5 sentences each.
- Includes keywords to boost natural search rankings.
Make sure your sub-headings are front-loaded with search terms and make them active.
- gerunds, eg ‘Apply for a licence’ not ‘Applying for a licence’
- technical terms unless you’ve already explained them
- ‘introduction’ as your first section – users don’t want an introduction, just give the most important information
Don’t use FAQs
FAQs are strongly discouraged on GOV.UK. If you write content by starting with user needs, you won’t need to use FAQs.
FAQs are discouraged because they:
- duplicate other content on the site
- can’t be front-loaded (putting the most important words people will search for), which makes usability difficult
- are usually not frequently asked questions by the public, but important information dumped by the content editor
- mean that content is not where people expect to find it; it needs to be in context
- can add to search results with duplicate, competing text
If your call-centres get questions that really are frequently asked, get in touch and GDS will help find a way to take care of those user needs.
Writing to GOV.UK style
It’s important to stick to the style guide. The style guide is based on a lot of user testing.
GDS commissioned research on the impact of style guides. Have a look.
To keep content understandable, concise and relevant, it should be:
- clear and concise
- brisk but not terse
- incisive (friendliness can lead to a lack of precision and unnecessary words) – but remain human (not a faceless machine)
- serious but not pompous
- emotionless – adjectives can be subjective and make the text sound more emotive and like spin
- use contractions (eg can’t)
- not let caveats dictate unwieldy grammar – eg say ‘You can’ rather than ‘You may be able to’
- use the language people are using – use Google Trends to check for terms people search for
- not use long sentences – check any sentences with more than 25 words to see if you can split them to make them clearer
(Note: words ending in ‘–ion’ and ‘–ment’ tend to make sentences longer and more complicated than they need to be.)
Use the active rather than passive voice. This will help us write concise, clear content.
Addressing the user
Address the user as ‘you’ where possible. Content on the site often makes a direct appeal to citizens and businesses to get involved or take action, eg ‘You can contact HMRC by phone and email’ or ‘Pay your car tax’.
DON’T USE BLOCK CAPITALS FOR LARGE AMOUNTS OF TEXT. IT’S HARD TO READ.
Use contractions eg can’t, you’ll. Some organisations are reluctant to use them but we’ve never encountered a problem with understanding when testing with users.
Sometimes, lots of ‘cannot’, ‘should not’ etc can seem archaic and formal. That’s a tone we can move away from without jeopardising the overall tone of information coming from government.
Use ‘to’ instead of a dash or slash in date ranges. ‘To’ is quicker to read than a dash, and it’s easier for screen readers.
Always explain what your date range represents, eg ‘tax year 2013 to 2014’ or ‘September 2013 to July 2014’. Date ranges can be the academic year, calendar year or tax year. This is why date ranges must be very, very clear.
If you’re comparing statistics from 2 different tax or financial years, use ‘Comparing the financial year ending 2011 with that ending 2012, there was a 9% decrease’.
GOV.UK gets over 50 million visits a month. There is no guarantee that only your intended audience will find your content, or that everyone will understand what you mean.
But we can make sure we get as close to accessible for everyone as we possibly can, simply by being very, very clear.
Make sure text is gender neutral wherever possible. Use ‘them’, ‘their’, ‘they’ etc.
Front-load your link text with the relevant terms and make them active and specific. Always link to online services first. Offer offline alternatives afterwards (where possible).
Plain English is mandatory for all of GOV.UK. One of the parts most people pick up on is the plain English (or words to avoid) list.
This isn’t just a list of words to avoid. Plain English is the whole ethos of GOV.UK: it’s a way of writing.
The list isn’t exhaustive. It’s an indicator to show you the sort of language that confuses users.
Don’t use formal or long words when easy or short ones will do. Use ‘buy’ instead of ‘purchase’, ‘help’ instead of ‘assist’, and ‘about’ instead of ‘approximately’.
We also lose trust from people if we write government ‘buzzwords’ and jargon. Often, these words are too general and vague and can lead to misinterpretation or empty, meaningless text. We can do without these words.
With all of these words you can generally get rid of them by breaking the term into what you’re actually doing. Be open and specific.
Write conversationally – picture your audience and write as if you were talking to them one-to-one but with the authority of someone who can actively help.
Writing about disability
When to use ‘we’
In the ‘about us’ section of the organisation page, lead with ‘we’ – it will be very obvious who the ‘we’ is on this page.
In policies, ‘we’ is also used, for example, ‘We announced our intention to do x as part of the coalition agreement.’
However, it’s not obvious who ‘we’ is in all content. For example, in a publication or detailed guide, users might enter the content in the middle of a page. They could arrive at an H2 heading from the navigation bar on the side, or skim read from the top until they find the section they want.
Using ‘we’ is fine, as long as you’re making it clear as much as possible who the ‘we’ is. Don’t assume the audience will know. Each time you use ‘we’, make sure you’ve already used the full name of the department or agency in that specific section.
Check your content is working for your users
You should regularly confirm that your content works for your users. You can check:
- on page searches in analytics (often an indication people didn’t find what they were looking for on that page)
- how users got to your page and where they clicked next (are they going where you expected or wanted them to?)
- user feedback left on GOV.UK through the Feedback Explorer
- feedback from any offline channels, eg helplines
When you edit or change a document, write what’s changed in the ‘Change note’ field - this is publicly viewable. Change notes should only include factual changes that specifically affect the user in the task which they’re trying to perform.
Change notes will trigger an email alert to everyone who’s subscribed to the sub-topic the publication is tagged to.
Use change notes to tell users:
- what has changed
- who is affected
- any agencies, departments or organisations that are responsible for the change
Don’t use changes notes for telling users:
- about minor editorial corrections or layout issues
How to write a change note
Focus on why the page has been changed. Concentrate on any new actions that the user may have to perform. This includes any penalties or charges they need to be aware of when performing a task. Don’t include date of change to document as that will automatically change.
Try to avoid phrases like ‘This page has been updated to include…’. Enter something short but useful, make it a clear statement of what’s happened.. For example:
‘Potatoes have been added to the banned vegetable import list from outside the EU.’
If the change on the page is sign-posting an upcoming issue, the change note should also reflect that. For example:
‘From 1 January 2015, VAT paid on digital services will depend on the country the customer is in, not the supplier of the service.’
Once the change has happened, the new change note should read similar to:
‘VAT paid on digital services now depends on the country the customer is in, not the supplier of the service.’
Change notes will trigger an email alert to users who are subscribed to alerts including policy, policy areas, topic, sub topic and filtered publications.
Users can read change notes by clicking ‘see all updates’ and then ‘full page history’.