BETA This playbook is in BETA, we think it’s good enough to be useful right now, but there are gaps that need filling – your feedback will help us to improve it.

Navigate this page
Back to Content

Contents

Find out about the types of content that we have and the ways that we set pages out

LayoutContact detailsLinksLists

Layout

We use the following layouts for each content type.

  • General content – For information pages and setting out the steps of a service we use a simple content layout. Long pages can also be split by tabs and headings so that it is easier to read and understand.
  • Emotive – We use an emotive template for information that has images that relate to the service or information that is being provided. Emotive content design is about using words and the overall design of the web page to make the reader feel something specific.
  • Tables – We use a table layout to neatly lay out uniform information so that it is easier to read.
  • Directories – Where we have a lot of records that need to be published that follow a similar layout, we create a directory. This means that all the records can be listed in one place and they can be searched for and filtered.
  • Blog posts – We create blog posts for small pieces of news or information. The posts are usually listed on one page and sometimes signpost the reader where they can read more.
  • Locations – We use a location template to create records for places where a service is delivered. They can then be listed together, usually alphabetically. The user can then find the location and read more about what is delivered from a particular place.

Contact details

Phone and fax numbers

We always use freephone (rather than phone) for a free phone number (such as 0800, 0508).

inset-text

Example
‘If you just need some medical advice, you can phone a registered nurse on Healthline, freephone 0800 611 116.’

Examples
Phone 01823 456239

Email admin@zyxvw.co.uk
We do not use bullets for lists of contact details.

Freephone 0800 123 4547

Email alpha@beta.com

Not

  • Freephone: 0800 123 4547
  • mail: alpha@beta.com

Street addresses

We write Street, Road, Avenue, Drive, Terrace in full.

We use en dashes without spaces between a range of street numbers.

inset-text

Example
112-114 Lambton Quay.

For street names such as ‘The Terrace’, ‘The Square’, ‘The Octagon’ the ‘The’ always has a capital.

We write a street address as:

[level or floor] [building name]
[street number and name]
[suburb or village]
[town or city]
[county]
[Postcode]

Postal addresses

We use ‘PO Box’ and then the number. There should be no spaces or punctuation in the number.

inset-text

Example
PO Box 234567, not PO Box 23-4567 or PO Box 23 4567.

  • not together – it is clearer to say that people are not in a relationship
  • in order to – ‘In order’ is unnecessary, so we leave it out – ‘To use this service…’
  • it’s important to or it’s vital to – it is not our job to tell people what is important to them, either they have to do something or they don’t
  • lets you do or allows you to – it sounds like people serve the service, not the other way around
  • please – ‘please phone’, ‘please email’ should be ‘phone’ or ’email’
  • sets out – we use ‘shows’
  • simply – we will explain a simple process simply, rather than saying it is simple
  • will – when we do not need this word, for example
  • you need a copy of your birth certificate
  • not – you will need a copy of your birth certificate
  • your needs – state the actual needs instead.

We also avoid using jargon like

  • advancing
  • agenda – unless it is for a meeting
  • collaborate – we use ‘working with’
  • combating
  • commit, pledge, aim – we need to be more specific – we are either doing something or we are not
  • countering
  • currently
  • deliver – pizzas, post and services are delivered, not abstract concepts like ‘improvements’ or ‘priorities’
  • dialogue – we speak to people
  • disincentivise and incentivise
  • drive – we can only drive vehicles, not schemes or people
  • empower
  • entity
  • facilitate – instead, we say something specific about how we are helping
  • focusing
  • foster – unless it is fostering children
  • going forward – it is unlikely we are giving travel directions
  • impact (as a verb)
  • initiate
  • key – unless it unlocks something, it is probably just ‘important’
  • land – as a verb, unless you are talking about an aircraft
  • leverage – unless in the financial sense
  • liaise
  • one-stop shop – we are a local government, not a retail outlet
  • outcomes
  • overarching
  • progress – as a verb – say what you are actually doing
  • ring-fencing
  • robust
  • stakeholder – this means nothing or everything, and everyone has a different definition for it – say who is involved
  • streamline
  • strengthening – unless it is strengthening bridges or other structures
  • tackling – unless we are talking about contact sports
  • transforming – we state what people are actually doing to change a thing
  • utilise – we say ‘use’ instead.
  • We write words like ‘realise’, ‘solemnisation’ and ‘standardise’ with an ‘s’ not a ‘z’.

Lists

We use lists to make it easier for people to

  • scan the page, and
  • understand information by visually separating out the points

We use bulleted lists to list items or points, and numbered lists for processes where the order of steps is important.

We try to

  • keep our lists short (2 to 7 items)
  • only use 1 level of nesting.

Bulleted lists (unordered lists)

We use 2 types of bulleted lists — single-sentence lists and multi-sentence lists.

When we are writing a single-sentence list, we

  • start with a stem sentence that all the points have in common
  • start each point in lowercase, and only use a full stop on the last point
  • sometimes use ‘and’ or ‘or’ on the second-to-last point
  • place a comma after the last word before the ‘and’ or ‘or’
  • check that each point makes a full sentence when read with the stem.

Multi-sentence lists are introduced by a complete sentence.

  • Each point in the list is also a complete sentence
  • Each point can be 1 to 3 sentences long
  • Each point begins with a capital letter and ends with a full stop

Numbered lists (ordered lists)

We use numbered lists for processes, where steps need to be done in order.

1. First, you do this.
2. You do this next.
3. To finish the process, you do this.

Tips for more complex lists

There are 3 main options for managing more complex information in lists – for example, when there is extra information attached to some bullets and not others, or when points have nested bullets and others don’t. The main aim is to make the information as clear as possible to read.

Use en dashes

Use en dashes to separate the information in a single-sentence list – although not grammatically correct, it is clear to read. If you’re using a lot of en dashes, you might need to consider one of the other methods.

inset-text

Example
To complete your application, collect evidence of

  • doctor’s or medical fees – keep the receipt or invoice showing the date, cost and reason for your visit
  • travel to your doctor or hospital
    • keep your ticket or receipt showing the date, cost and how you travelled
    • if you travelled by car, supply the cc rating of your car and how far you travelled
  • prescriptions
    • ask your chemist for a print-out of your medications including the date, cost and if they are subsidised, or
    • keep your receipts.

Use a multi-sentence list

Turn the list into a multi-sentence list.

inset-text

Example
Here are some examples of the information you can collect for your application.

  • For doctor’s or medical fees, keep the receipt or invoice showing the date, cost and reason for your visit.
  • For travel to your doctor or hospital
    • keep your ticket or receipt showing the date, cost and how you travelled
    • if you travelled by car, supply the cc rating of your car and how far you travelled.

For prescriptions

  • ask your chemist for a print-out of your medications including the date, cost and if they are subsidised, or
  • keep your receipts.

Restructure the content

Restructure the content into headings and sub-headings.

inset-text

Example
Doctors and medical fees
Keep the receipt or invoice showing the date, cost and reason for your visit.

Travel to your doctor or hospital
Keep your ticket or receipt showing the dates, cost and how you travelled. If you travelled by car, supply the cc rating of your car and how far you travelled.

Prescriptions
There are 2 ways to get the information you need:

1. Ask your chemist for a print-out of your medications, including the date, cost and if they are subsidised.
2. Keep your own receipts.

Last reviewed: September 4, 2023 by Jennifer

Next review due: March 4, 2024

Back to top