Content guidelines

You can use the Suffolk County Council web content guidelines to write clear and effective online information.

Help us improve these guidelines by emailing your feedback to digitalcontentteam@suffolk.gov.uk.

We've created these guidelines for suffolk.gov.uk content editors. They're based on user research and established best practices. They will help you publish clear, simple and effective web content. 

You may also find this guide useful if you manage or edit:

  • County council service information websites
  • District, Borough, Town or Parish council websites
  • NHS, Police or other public sector websites
  • Community or voluntary websites

Guidelines: how to plan, write and manage your content

You can read a summary of the content guidelines below. For more detail and examples read the full guidance.

Plan your content 

Plan your content before you start writing. 

Focus on the user. Structure your content based on a few questions, including:

  1. Who's looking for this information? 
  2. What do they need to know?
  3. Why will it help them?
  4. Can the user help themselves without accessing a council service?
  5. How can you make the most important information clear?
  6. Where does the user need to go next?

How to write for suffolk.gov.uk

You should:

  • publish content that's useful, specific and authoritative
  • aim for a reading age of 9 to 11 years old 
  • write clearly and simply in plain English
  • use short, simple everyday words
  • use the active voice 
  • address the user, for example: 'you can...'
  • keep your sentences short (fewer than 25 words)
  • make paragraphs concise (even one sentence)
  • avoid jargon
  • explain any technical, legal or other specialist words or phrases
  • use a neutral tone of voice
  • do use positive contractions, for example: 'We'll'
  • do not use negative contractions, for example: 'don't' 

Create clear page titles and summaries 

Your titles and summaries need to be clear, simple and descriptive. 

The character limit is: 

  • 65 for titles
  • 160 for summaries 

Page titles should be front-loaded. Put the format type (consultation, guidance) at the end of the title. 

Keep summaries active. Explain what people can do on the page. Avoid redundant words. 

Format your content 

People do not read a whole webpage. Your content needs to be easy to scan.

Use formatting techniques and features to make content clearer. You can use:

  • the inverted pyramid (most important information at the top)
  • sub-headings to make the page easier to scan
  • bold text for highlighting important details
  • bullet points for lists
  • tables for clear dates and times 
  • buttons for the most important link (for example: download, proceed to payment)
  • accordions and tabs to make page more usable

Adding links, documents, images and other media 

Make sure you understand how to publish different types of links, files and media should.

Links

  • Make it clear where a link will take you
  • Make link text active, include a verb (for example: 'Find out more about tax on GOV.UK')
  • Add alternative text (alt text)
  • Open internal links in the same tab. Open external links in a new tab
  • Do not signpost without context, for example: listing links under a generic 'further information' heading'
  • do not link any part of headings

Documents

  • Publish information as page content (HTML) not files (such as PDF) wherever possible
  • Format file links as: Download the example document (Word, 12KB)
  • Add alt text to the file link
  • Document file size should be less than 2MB

Images

  • Use images to explain information, not for decoration
  • Images should not contain text, as screen readers and search engines can not read it 
  • Make sure information in graph images is also accessible in the page content
  • Add alt text to images for accessibility and search
  • Ensure image quality is acceptable
  • Image file size should be less than 500KB

Other media

We can embed the following types of media on suffolk.gov.uk: 

  • Google maps 
  • YouTube videos
  • PageTiger/Issuu digital magazines
  • Infographics (such as Piktochart)

Follow the style guidance

The way we write should be consistent across every page on suffolk.gov.uk.

Make sure you know how to write things like:

  • acronyms
  • addresses
  • dates and times
  • money and fees
  • numbers and ages
  • units of measurement
  • web terms

Make your content accessible

Websites should be usable for all. No one should be digitally excluded from Suffolk County Council services. 

We work to Level AA of the Web Content Accessibility Guidelines (WCAG) so our site is usable for everyone. 

You can help make your content accessible. You should: 

  • structure your sub-headings properly
  • add alt text to images
  • write clear and active link text
  • format tables, dates and times correctly
  • not using symbols, such as ampersands

Make your content easy to find in search engines

Many people start their visit to suffolk.gov.uk by using a search engine. This means it's important people can find your content in Google.

You can make your page easier to find. You should: 

  • write titles, summaries and page content in terms people use to search 
  • ensure your sub-headings are well structured
  • avoid publishing information as images
  • add alternative text to images
  • add metadata to the page
  • avoid duplicating content 
  • not publish pages with little information
  • get links to your page from authoritative, trusted websites

Edit and proofread before publishing

Before you publish you should: 

  • edit your content to make it clearer and more concise
  • proofread it to spot typos and other errors

Common mistakes to avoid include: 

  • misspellings 
  • homophones
  • tautologies
  • apostrophes
  • technical differences, for example: fewer versus less

Manage your content after publishing

After you publish your content you should: 

  • look at analytics to know how people are using your page
  • check your content for issues, such as broken links
  • keep your content and editing skills up to date

For more detail about anything in this summary, read the full guidelines. You can send your questions and feedback to digitalcontentteam@suffolk.gov.uk

This section includes: meeting user needs, questions to consider before you start

Meeting user needs

User needs are the reasons people use a website. 

People use suffolk.gov.uk to access local services. They're searching for information, or trying to complete a task. They are not here to browse. 

Meeting their needs means helping them find what they need quickly and easily. You should assume they have no prior knowledge of the page topic. 

Our content guidelines will help you write content to meet user needs effectively. 

Before you start: six questions

When planning your content, think about: 

  1. Who's looking for this information?
  2. What do they need to know?
  3. Why will it help them?
  4. Can the user help themselves without accessing a council service?
  5. How can you make the most important information clear?
  6. Where does the user need to go next?

You should plan and structure your content based on the answers. 

This approach will ensure you meet user needs for every page your write.

This section includes: how people read on the web, front-loading, reading age, plain English, tone of voice, sentences and paragraphs, active voice, addressing the user, when to use 'we', contractions, behaviour nudges, writing about disability

Principles of writing for suffolk.gov.uk

Your content should come across as:

  • useful by answering a question or helping to complete a task
  • simple by using common, everyday words and phrases
  • specific by using precise language, such as 'must' for legal requirements
  • concise by using short sentences and paragraphs, and only what's needed
  • authoritative by being straightforward, but not too casual or informal

How people read on the web

People read differently on the web compared to on paper.

They will scan web information, rather than reading every word, looking for what they need. Research shows that people only actually read 20 to 28% of a webpage. 

Website users will also read in an F-shape pattern. They scan across the top of the webpage, then down the left side and across to find what they need. 

This means your content should be written so people can easily scan it. Users should be able to understand the information without having to read every word in order. 

Front-loading

The way people read online means you should 'front-load' page titles, sub-headings and bullet points. This involves putting the words people are scanning for at the left of the title, heading or bullet.

Example: 'Roadworks in Suffolk', not 'Find out about roadworks in Suffolk'. 

Reading age

Applying a reading age to content tells us how hard it is to read. The higher the reading age, the more difficult it is to understand. 

There are many readability tests, such as the Flesch-Kincaid readability test

Many website users have a low reading age. This may be due to poor literacy skills, or because English is not their first language. 

You can make sure content easier to read and understand by writing simply and concisely. Simple writing makes content easier to understand for all users, not just those with a low reading age. 

For suffolk.gov.uk we aim for a reading age of 9 to 11 years old.

Test the readability of your content by using an online tool like Hemingway Editor

Plain English

You should write content simply, using plain English. This will make it easier for people to understand your information. 

Plain English means using short, simple and familiar everyday words. It avoids long words, technical language or jargon, which is vague and unspecific. 

For example, this sentence is full of jargon:

'We engage in horizon-scanning to anticipate future growth of demand for services.' 

You could instead write it in plain English:

'We plan for who might need to use our services in future.'

If you need to use legal, medical or other terms only known to specialists, explain what it means using plain English. 

Jargon to avoid

  • agenda (unless it's for a meeting)
  • deliver (pizza and letters are delivered, services are provided)
  • dialogue (we speak to people)
  • drive (you can only drive vehicles; not schemes or people)
  • foster (unless it's children)
  • horizon-scanning (more likely you’re planning for future needs)
  • impact (as a verb)
  • progress (as a verb – say what you’re actually doing)
  • strengthening (unless it’s strengthening bridges or other structures)
  • tackling (unless it's rugby, football or another sport)

Here is a longer list of words to avoid from GOV.UK

Everyday word alternatives

  • ‘buy’ instead of ‘purchase’
  • ‘about’ instead of ‘approximately’
  • ‘working with’ instead of ‘collaborating with’
  • ‘begin’ instead of ‘initialise’
  • ‘talking to’ instead of ‘engaging with’
  • ‘changes’ instead of ‘modifications’
  • ‘many’ or ‘several’ instead of ‘multiple’
  • ‘put in place’ instead of ‘implement’

Here is an A to Z of alternative words

Tone of voice

Your content should have a neutral and consistent tone. It should not have a distinct individual style. 

Websites are not a conversational medium. They are different to how we might communicate with a user on webchat or social media.

Example: 'You can contact us', not 'give us a ring'. 

Using a neutral tone ensures content is consistent and appropriate across every page. 

Sentences and paragraphs

Shorter sentences are easier to read.

Here's an example of a sentence that's too long: 

If a sentence in your webpage is over 25 words in length, try editing it into two or more shorter sentences without any unnecessary words included. 

Instead you should write: 

'Sentences over 25 words are too long. Edit long sentences into two or more shorter sentences.'

Separate two sentences using a full stop, not a semi-colon. 

Concise paragraphs are also easier to read. Try to break up long paragraphs into a series of short paragraphs. 

Sometimes a paragraph can be a single sentence. 

Active voice

Write using the active voice, not the passive voice. This helps users scan content. 

Example: 'Report a pothole online' is active; 'Potholes can be reported online' is passive. 

You can find out if your writing is active or passive using Hemingway Editor

Address the user

Refer to the user as 'you' where possible. It helps make content clearer. 

Example: 'You can apply using the portal', not 'Applications can be made using the portal'. 

When to use 'we'

You can refer to Suffolk County Council or a specific service as 'we' if it's clear who 'we' are.

Users can arrive at a webpage from anywhere. So be clear in your title, summary and first paragraphs if 'we' are the whole council, a directorate or specific service.  

Contractions 

Use positive contractions such as 'you'll' and 'we'll'. 

Do not use negative contractions such as 'can't' or 'don't'. These are harder to read, and users may misunderstand them. 

Using contractions does not make your content unprofessional or too casual. It's an everyday way of speaking that makes content feel more natural. 

Behaviour nudges

Nudges are psychological techniques used to shape a person's behaviour.

They've been used by companies for a long time. Now they're increasingly being used in the public sector, for example: to encourage better health choices. 

We use behavioural nudges to manage the user journey on suffolk.gov.uk. 

There are many reasons we might want use behavioural nudges. For example, to encourage people to contact us online. This saves money compared to phone calls.

Examples of nudges: 

  • '80% of people report a problem using our online tool' - emphasising online is the norm
  • 'The main way to pay is to use the online portal' - establishing digital is the default
  • 'If you apply by post it'll take longer to hear back from us' - here there's an incentive of quicker response
  • 'By contacting us online you help us spend more on front-line services' - this appeals to ego of having a positive affect on society

Nudges are not a 'dark art' if used for the right purposes. Our aims for nudging people are ethical and justified.

Research shows that nudges can work even if we're told we're being nudged. This means you can be transparent with users, and let them know why we are trying to shape their behaviour. 

Disability

Some tips for writing disability-related content:

  • Be consistent – try to avoid slipping into a patronising tone
  • Use appropriate terms (‘disabled people’ or ‘people with disabilities’, not ‘the disabled’)
  • Avoid medical labels – they reinforce stereotypes of disabled people as ‘patients’
  • Be mindful – many people don’t consider themselves ‘disabled’, but identify as having a ‘health condition or impairment’
  • Stay positive - avoid phrases like ‘suffers from’ or ‘confined to’ which suggest pain and victim status; use ‘has [condition or impairment]’
  • Write normally – aim to create content for disabled people in the same way you would for everyone else

Here is more guidance about words to use and avoid when writing about disability

This section includes: page titles, summaries

Page titles

Title length

Your title should be 65 characters or less (including spaces).

Longer titles are harder to read, and Google cuts off titles after 65 characters. 

Make your titles clear and descriptive

Most people who use suffolk.gov.uk start with a search engine, such as Google. Your page title should:

  • be written using the language people would search for
  • make sense on its own 

You should not use the terms most people use if there is a misconception. For example, it's the Register Office, not Registry Office. 

If you must use official terms in a page title, use plain language in your page summary.

Example: the 'Household Waste Recycling Centre' page should mention 'tip' or 'dump' in the summary. These are the keywords people may use when searching. 

Using ‘ing’ in titles

Use the active verb (for example ‘Apply’) if you use the page to do the thing.

Example of good form title: Apply for a school place.

Use the gerund (‘Applying’) if the page is about doing the thing, but you do it elsewhere.

Example of good guidance title: Applying for a school place.

Formatting your title

You should put the format type at the end of a page title, not the beginning. This follows our guidance about 'front-loading' titles and sub-headings. 

Examples:

  • 'New highways works consultation', not 'Consultation about the new Highways works'
  • 'Trading Standards guidance' not 'Guidance about Trading Standards'

Summaries

Summary length 

Keep all summaries to 160 characters (including spaces). Google usually only shows the first 160 characters in search results. 

Describe the page content

The page summary is one of the things people see in search engine results (along with the page title and URL). So your page summary needs to clearly explain what the user will find on the page, and how it could help them. 

Example: the 'Blue badge scheme' page the summary could be:

'How to apply for a Blue Badge, the eligibility criteria, how to renew or replace your badge, and what to do if you are a new applicant.'

Include keywords in your page summary that people might search for but that you haven't included in your title. 

Do not repeat the title in your summary. Use the summary to expand on the title. 

Formatting your summary 

Keep summaries active and include a verb.

Examples: 

  • You can apply...
  • How to pay...
  • When reporting...

Summaries should end with a full stop. This can help people who use assistive technology like screen readers.

Avoid redundant introductory words

These do not tend to give the user any more information than what they would already assume.

Examples:

  • Information about...
  • A consultation on...
  • This form will allow you to...
  • Please complete...

Remove as much as you can without losing critical information.

This section includes: page length, inverted pyramid, sub-headings, bold text, bullet points, number lists, tables, shoutboxes, buttons, accordions and tabs

Page length

There is no limit to page length on suffolk.gov.uk. 

However, always make sure a content page is only as long as it needs to be. 

You can use the formatting guidance in this section to ensure your content is clear, concise, and easy to scan.

Inverted Pyramid

The inverted pyramid is a practice where you put the most important information at the top of the webpage. 

The pyramid shape reflects that your writing should go from the broadest facts down to the smallest details. 

For example on an 'Apply for a school place' page, information about:

  • how, when and where to apply should be at the top
  • how we process applications should go at the bottom

Find out more on the Nielsen Norman Group website: Inverted Pyramid: Writing for Comprehension

Headings

Use sub-headings to divide up content into sections of related information. 

These headings help people and search engines scan a webpage and understand what the page is about. People using screen readers use sub-headings to navigate a page to find the information they need. 

Sub-headings must be well structured, or they will confuse users and search engines. 

You should used headings like this: 

  • Heading 1 is the page title. There should never be more than one Heading 1 on a webpage. 
  • Heading 2 is used to divide the webpage into sections.
  • Heading 3 is used to sub-divide the content under a Heading 2.
  • Heading 4 is used to sub-divide the content under a Heading 3.

Always make Heading 2 the first sub-heading used after the page title. 

If a page is only divided using Heading 3 or Heading 4 search engines and screen readers will view this as the page 'missing' a Heading 2. 

Do not use Heading 5, 6 and so on. Too many heading types are confusing. 

Do not link any part of sub-headings. 

Bold text 

You can use bold to help users scan for important information, such as dates or costs.

Example: 'The deadline for applications is Friday 30 October'.

It can also be used for emphasis.

Example: 'Do not report this online if it's an emergency'.

Use bold sparingly to avoid it becoming meaningless and distracting. Some pages do not need any bold text. 

Never highlight a whole sentence, paragraph or link in bold. 

Bullet points

Use bullet points to make lists easier to scan. Bullets are appropriate when the order of list items does not matter.

When using bullets:

  • write a lead-in line ending in a colon, for example ‘When using bullets:’
  • use lowercase at the start of each bullet if continuing the sentence
  • don’t use ‘or’, ‘and’ or a semi-colon after each bullet
  • don’t add a full stop after the last bullet point
  • limit yourself to 5-10 items per bullet list

Good example

On suffolk.gov.uk you can: 

  • report
  • apply 
  • pay

Bad example

On suffolk.gov.uk: 

  • you can report
  • you can apply
  • you can pay

Number lists

Use numbered lists to present ordered information.

For example, step-by-step instructions to complete a task:

  1. This is step 1
  2. Here's step 2
  3. And now step 3

Tables

Use tables to display information such and timetables, opening hours or budget figures. Do not use tables to control the layout of your page.

Example of a well formatted table: 

Opening hours

Monday to Friday 9am to 5pm
Saturday 10am to 4.30pm
Sunday Closed

Shoutboxes

Shoutboxes look like this. You can use them to highlight important information. 

Avoid overusing shoutboxes, as this makes them less noticeable. 

Buttons

Use buttons to highlight the most important link or download on the page.

This is known as a call to action. It's the main thing the user needs to do when visiting the page. 

For example, on the 'Pay an invoice' page, the link to the external payment form should be a button.

Example button 

Proceed to payment

The link text on a button should describe what happens when you click the button.

For example: On the 'Pay an invoice' page the button text should be 'Proceed to payment'. It should not say 'Make a payment' or 'Pay now' as the user can't complete their payment by clicking the button. 

Do not use more than one or two buttons on a single webpage. 

Accordions

Accordions are webpage features that expand to show more content. On this guide, "Formatting your content" is an accordion. 

Use accordions for long pages where the user may only need to look at one section of information. For example, FAQ pages. 

Treat the accordion title as a Heading 2. 

Tabs

You can use tabs to segment your page content. 

On suffolk.gov.uk, the first tab is always 'open' and displays its content. 

Use tabs for similar reasons to accordions, but where your page sections are limited. (You can only add up to 5 tabs on a suffolk.gov.uk webpage.)

Treat the tab title as a Heading 2. 

This section includes: links, documents, images, videos and other media

Links

You can use links to help people navigate to pages on suffolk.gov.uk and to external websites.

Only add links that are useful to your page. 

Internal links should open in the same browser tab.

External links should open in a new tab. 

Signposting

Do not signpost to further information without context, for example: links listed under a generic 'further information' heading. 

Signposting is not effective if it's unclear why you should visit an external page. 

You should explain what the user can do when clicking the link. 

Example: 'You can learn more about SEN funding on suffolksendiass.co.uk'.

Include external links within the main page content, not a separate 'external links' area of the page. 

How to format links

Make your link text active, concise and include a verb if possible.

Good example: Find bus timetables on suffolkonboard.com

Bad example: Bus timetable are available on Suffolk Onboard: https://www.suffolkonboard.com/buses/timetables/

Add descriptive alternative text (alt text) to your link. This is read by screen readers to tell people what the link is about. 

Do not use generic link text such as 'click here'. 

Do not link any part of sub-headings.

Documents

How to publish information

Publish information as webpage content (HTML) rather than files (such as PDFs) wherever possible. 

This is because PDFs: 

  • do not change size to fit a web browser
  • are not designed for reading on screens
  • don't allow us to track how people use them offline
  • can be hard for some people to access
  • are harder to keep up to date

More information: Why GOV.UK content should be published in HTML and not PDF

The maximum file size for suffolk.gov.uk is 5MB. You should aim for your file to be less than 1MB if possible. There are many free online tools that can shrink your file size. 

Formatting your document link

The format for document links should be active, concise and include a verb if possible. 

Include the file type and size in brackets after the document link. 

Good example: Download the example document (Word, 12KB)

Bad example: You can download the document here

Images

When to use images

You should use images to explain information, not for decoration. 

Good example: An image showing pothole depth can help explain what a dangerous pothole looks like

Bad example: An image of children in a classroom on a school term dates page is decorative, as it does not help explain anything

Resolution, size and file type

Images should be of appropriate resolution, size and file type. As a guide aim for:

  • 800px width (if landscape)
  • less than 500KB
  • PNG or JPEG file formats

Make your image accessible and searchable

Add clear and descriptive alternative text (alt text) to your image. This tells people with screen readers what the image shows. This will also help people find your page through search engine image results. 

Do not include text on your image. This makes the information inaccessible to screen readers and search engines. 

If you publish graphs as image files, make sure the details are also available in the editable page content.

Videos

You can embed YouTube videos on suffolk.gov.uk. 

Make sure any page with videos still has enough content around it (text, headings). This helps search engines and screen readers read the page and understand what it's about. 

Embedding videos is simple and quick. You have the option to resize the video to work best in your page layout and for mobile devices. 

Ask the Digital Content Team for support if you need help adding a video to your page. 

Other media 

We sometimes embed other media formats on suffolk.gov.uk. For example: Google maps or digital magazines using publishing tools such as PageTiger or Issuu. 

Please ask the Digital Content Team about adding non-standard media to a page. 

This section includes: abbreviations, acronyms, addresses, capitalisation, dates and times, hyphens, italics, money and fees, numbers and ages, quotations, semi-colons, singular and plural, symbols, units of measurement, web terms

Abbreviations

Avoid abbreviating words and phrases. They are harder to read, and may sound confusing when using a screen reader.

For example: write 'for example' in full rather than 'e.g.'

Acronyms

When first mentioning an acronym on any page, write in full with the acronym in brackets.

For example: start by writing ‘Multi-Agency Safeguarding Hub (MASH)'. You could then refer to 'MASH' for the rest of the page.

Addresses

When writing addresses use the format:

Suffolk County Council,
Endeavour House,
8 Russell Road,
Ipswich,
Suffolk,
IP1 2BX

Capitalisation

Capital letters make sentences 13 to 18% harder to read.

Begin page titles with a capital letter and continue in lowercase.

Example: 'Apply for a school place' not 'Apply For a School Place'. 

Never write in all capitals, as online this looks like we’re shouting. The exception to this is when using acronyms or initialisms, for example: ACS, DVLA or GOV.UK.

Dates and times

Use the date format ‘Thursday 16 October 2018’ 

Do not use 24-hour clock - this requires extra effort for the user to 'convert' the time. Write '5pm' not '17:00'.

Write date and time ranges using the format 'Monday to Friday, 9am to 5pm' not 'Mon-Fri, 9am - 5pm'

Be specific with dates if you can.

Example: 'Applications open on Monday 12 September' not 'Applications open next Monday'.

Hyphens

Examples of words on suffolk.gov.uk that should include hyphens:

  • by-election
  • co-ordinate
  • in-house
  • on-site

Words that shouldn't have hyphens:

  • email
  • ebooks
  • ecommerce
  • online

Italics

Do not use italics on suffolk.gov.uk. 

Italics are harder to read online, and can add tone to information which we want to avoid. 

Money and fees

Write money in the format: £2.50; £250; £2,500, £25,000, £250,000; £2.5 million; £2.5 billion.

Numbers and ages 

The conventional way to format numbers is to spell numbers up to ten, then use digits for larger numbers. For example, 'nine', ten', '11', '12'. 

On suffolk.gov.uk, always use digits unless you're starting a sentence with a number.

Example, you would write 'There are 3 ways to apply', but 'Three ways you can apply'. This makes it easier for people to scan for numerical information.

The format for large numbers is: 100; 1,000; 10,000; 100,000; 1 million; 1 billion. 

Write decades using the format ‘1980s’, not ‘1980’s’, ‘80s’ or ‘eighties'.

When writing ages, use the formats 'The 21-year-old woman' and 'The woman is 21 years old'. 

Quotations

Write quotations like this:

  • The councillor said: “This is an example quote.”
  • The councillor said he was “very happy” with his quote.
  • The councillor said he’d give one more quote that was “great”.

When dividing long quotations into shorter paragraphs, use this format:

The fire officer said: “I like giving example quotes too.

“It’s useful to know how to write quotations so I can teach others.

“I especially like quotes that continue onto three or more lines.”

Semi-colons

Do not use semi-colons to separate two sentences. Use a full stop instead.

Semi-colons are harder to read and may not be understood by users. 

Singular and plural

Write collective nouns as singular entities. This includes companies, governments and other organisations or groups. 

Example: ‘Suffolk County Council is’ not ‘Suffolk County Council are’.

Symbols 

Do not use ampersands (&). For example, write 'Roads and transport' not 'Roads & transport'.

Do not add exclamations (!). If you need to highlight an important message us bold text for the relevant part of the sentence. 

You can use the symbols for percentage ('%') and the pound sign ('£').

Units of measurement

Use metric units on suffolk.gov.uk.

If you need to use imperial units, provide a conversion to metric units. For example, 'The road is 10 miles (16km) long.'

Write temperatures in the format 'Today's temperature is 23C'. 

Web terms

When linking to a website use the format 'suffolkjobsdirect.org'. Do no include 'http://www.' prefix characters or any unnecessary slashes. 

Write: 

  • website not web site
  • webpage not web page
  • webchat not web chat

This section includes: web accessibility standards, how to make your content accessible

Web accessibility standards

Content on suffolk.gov.uk should comply with Level AA of the Web Content Accessibility Guidelines (WCAG)

This is an accepted standard of web accessibility. Complying with this standard ensures that our website is usable for everyone. 

How to make your content accessible

Headings

Structure pages with sub-headings in a logical order.

People using screen readers use sub-headings to navigate a page. They rely on well-structured headings for tabbing through the page to find what they need.

Structure your sub-headings in this way: 

  • Heading 2 is used to divide the page into sections
  • Heading 3 is used to sub-divide the content under a Heading 2
  • Heading 4 is used to sub-divide the content under a Heading 3

Always make Heading 2 the first sub-heading used after the page title.

If a page is only divided using Heading 3 or Heading 4 screen readers will view this as the page 'missing' a Heading 2.

Images

Always add descriptive alternative text (alt text) to your images. This helps people with screen readers understand what the image shows.

Example: 'Councillors talking to public in Stowmarket town centre.'

Do not publish images that contain text. Screen readers will not be able to read this information. 

Links

Always add descriptive alt text to your page and document links. This helps people with screen readers understand what the link is about, and where it will take them. 

You can use the link text as your alt text. Try to make it active, concise and include a verb.

Example: 'Download the application form' or 'Find out more on Suffolk InfoLink'. 

Avoid using terms like 'click here' as link text.  

Tables

Use tables to visualise data more clearly. Do not use tables to format or structure content. You can use headings, tabs or other formatting features for this.

Dates

Format dates as '9 July to 11 July' not '9 July - 11 July'. Screen readers will read the hyphen as 'hyphen', which make dates harder to understand.

Times

Write times as '2pm' rather than the 24-hour clock '14:00'. It's easier to understand using a screen reader.

Languages

Explain if non-English language is used in a page for any reason. 

Symbols

Use 'and' rather than the '&' symbol.

Example: 'Roads and transport', not 'Roads & transport' which a screen reader who read as 'roads ampersand transport'.

This section includes: why search is important, how search engines works, how to optimise your web content

Why search is important

Most people start their search for information online using a search engine.

Half of visits to suffolk.gov.uk start with someone using a search engine, such as Google. 

This means it's important that users can find your pages using search engines. 

How search engines work

Search engines aim to present the most relevant results for any search term. 

They do this by first building up an index of webpages on the internet. 

They then use a complex algorithm to rank pages for different search terms.

It's thought there are over 200 factors influencing the Google search algorithm.

Search Engine Optimisation (SEO) is the process of improving the ranking of your webpage on search results. 

SEO is a complicated and specialist practice. However, as a content editor you can influence how high your page appears for relevant search terms.

How to optimise your web content

Publish on an authoritative domain

Authoritative domains such as gov.uk or nhs.uk are more trusted by search engines. This means pages on those websites rank higher on search results pages. 

All pages on suffolk.gov.uk are considered authoritative and trustworthy. If you have the choice between publishing content on this website or a non-gov.uk domain, opt for suffolk.gov.uk; it will mean your page is more likely to rank highly with search engines. 

Meet the user need

Make sure your content is relevant and answers the questions people will have. 

If people visit your page and immediately return to their search results Google may think your page is not relevant. 

Include keywords people use to search

Write your page title, summary and content using the words and phrases people would use when searching. 

Do not try to 'trick' Google by repeating keywords unnaturally. This may result in a penalty, where Google stops your page from appearing on results pages. 

Make sure your page is well written and formatted

Write clear, concise and descriptive page titles, summaries, sub-headings and content. This helps both search engines and users understand what the page is about. 

Ensure your sub-headings are in a logical order. 

Do not put information in images

Search engines cannot read information in images, for example: text overlaid onto photos. 

If a lot of your page information is contained within images, search engines will think the page doesn't have much content. 

Add alternative text to photos

When you add photos to a page make sure you add alternative text (alt text). This helps the image (and page) show up in Google Image search. 

Avoid sparse pages or duplicate content

Google may penalise your website if it contains a lot of sparse pages or duplicate content. This means your website would not rank highly on search results pages. 

This would only apply to a trend found widely across a website, not just an individual page. 

Complete the page metadata

You can add metadata to your page when editing it in the Content Management System (CMS). 

This metadata is only read by search engines, and provides more information on what the page is about

Fix any usability issues

Make sure your page doesn't have issues that would cause a bad user experience, for example: broken links. 

Acquire good links from other websites

Search engines look at links to a page from other websites as 'votes' that your page is relevant and useful. 

Getting links from trustworthy and authoritative websites will help your page rank higher in search results. For example, if you publish a page related to healthcare for young people, links from NHS, university and other relevant websites will be beneficial. 

Be aware that it can take days or weeks for search engines to fully take account of all the links to your page and adjust its search ranking. 

Avoid bad links from other websites

If a lot of spam or low quality websites are linking to your page, search engines may penalise your page or website. 

There are lots of online tools to help monitor inbound links to a website. You can ask the Digital Content Team for more details. 

This section includes: editing, proofreading, misspellings, homophones, apostrophes, other common mistakes 

Editing and proofreading tips

Editing

When editing your content you should:

  • Delete redundant words
  • Split sentences over 25 words into two or more shorter sentences
  • Keep paragraphs concise (even a single sentence)
  • Check for readability using a tool like Hemingway 
  • Check content does not include any sensitive data

Proofreading

To spot mistakes in your writing you can: 

  • spellcheck, but do not rely on it (it will not tell you if you’ve used a word in the wrong context)
  • change the font to make it unfamiliar
  • print it out so you're reading it in a different context
  • read it aloud
  • read it backwards
  • ask someone else to read it 

Mistakes to avoid

Below are some common mistakes made by content editors. 

Misspellings

Write using British English, not American English.

Examples:

  • ‘recognise’ not ‘recognize’
  • ‘focused’ not ‘focussed’
  • ‘holiday’ not ‘vacation’
  • ‘pavements’ and not ‘sidewalk’
  • ‘lift’ not ‘elevator’

Make sure your spellcheck is set to British English. Refer to the Oxford English Dictionary if you’re ever unsure.

Homophones

These are words that are pronounced and spelled similarly, but have different meanings.

Make sure you’re using the correct versions of the following:

  • affect/effect
  • complement/compliment
  • formerly/formally
  • licence/license
  • practice/practise
  • principal/principle

Tautologies

This is when you use additional words that are unnecessary.

Examples of tautologies are:

  • new innovation 
  • mutual co-operation
  • past experience
  • honest truth

Apostrophes

Apostrophes are used to indicate possession or omission of words. 

Below are correct uses of apostrophes: 

  • This is Thomas' room
  • This is Thomas's room
  • Work will start in two weeks' time
  • Today's the day
  • You'll be contacted soon

Do not use an apostrophe when writing the plural of something, for example: there are 20 worker's. 

Other common mistakes

It’s easy to use the wrong version of the words below. Ensure you’re using the correct instance of the following.

  • a/an
  • farther/further
  • fewer/less
  • it’s/its
  • that/which
  • they’re/their
  • who’s/whose
  • your/you’re

This section includes: understanding how people use your content, monitoring your content for issues, keeping your content and editing skills up to date

The Digital Content Team can support you to manage your content. Please email digitalcontentteam@suffolk.gov.uk to ask about anything mentioned below. 

Understand how people use your content

It's easy to see how people use your page with tools such as Google Analytics. 

You should know how many people are visiting your page, and what they do when they arrive. 

If you don't know how your page is being used, you do not know if it's meeting user needs. 

Monitor your content for issues

You can use web quality assurance software such as Siteimprove to monitor your web content for issues. 

The main issues that affect websites are: 

  • broken links
  • misspellings
  • poor readability
  • accessibility issues
  • SEO issues

Issues can prevent people from being able to access your service.

The Digital Content Team are responsible for monitoring suffolk.gov.uk for issues, but you can get involved to manage issues for your area of information. 

Keep your content up to date

You are responsible for ensuring your online information is accurate as a content editor.

You should review your pages to edit any information or documents that are out of date. 

Keep your editing skills up to date

You should attend web editing training sessions to ensure you are following good practices.

Contact us

The Suffolk County Council web content guidelines are maintained by the Digital Content Team.

We co-ordinate suffolk.gov.uk content and editors. We're available from Monday to Friday, 9am to 5pm. 

You can send us your feedback or questions by emailing digitalcontentteam@suffolk.gov.uk.