Help us improve these guidelines by emailing your feedback to firstname.lastname@example.org.
How to use this guide
We've created this guide for suffolk.gov.uk content editors. It'll 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
Summary of the guidelines
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:
- Who's looking for this information?
- What do they need to know?
- Why will it help them?
- Can the user help themselves without accessing a council service?
- How can you make the most important information clear?
- Where does the user need to go next?
How to write for suffolk.gov.uk
- 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, e.g. '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, e.g. 'We'll'
- do not use negative contractions, e.g. '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 (e.g. 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.
- Make it clear where a link will take you
- Make link text active, include a verb (e.g. '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, e.g. listing links under a generic 'further information' heading'
- do not link any part of headings
- Publish information as page content (HTML) not files (e.g. 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
- 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
We can embed the following types of media on suffolk.gov.uk:
- Google maps
- YouTube videos
- PageTiger/Issuu digital magazines
- Infographics (e.g. 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:
- 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:
- technical differences, e.g. 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 email@example.com.
Planning your content
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.
Our content guidelines will help you write content to meet user needs effectively.
Before you start: six questions
When planning your content, think about:
- Who's looking for this information?
- What do they need to know?
- Why will it help them?
- Can the user help themselves without accessing a council service?
- How can you make the most important information clear?
- 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.
How to write for suffolk.gov.uk
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.
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'.
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.
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.
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.
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.
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, e.g. 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.
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.
Page titles and summaries
This section includes: page titles, summaries
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.
- 'New highways works consultation', not 'Consultation about the new Highways works'
- 'Trading Standards guidance' not 'Guidance about Trading Standards'
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.
- 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.
- Information about...
- A consultation on...
- This form will allow you to...
- Please complete...
Remove as much as you can without losing critical information.
Formatting your content
This section includes: page length, inverted pyramid, sub-headings, bold text, bullet points, number lists, tables, shoutboxes, buttons, accordions and tabs
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.
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
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.
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.
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
On suffolk.gov.uk you can:
- you can report
- you can apply
- you can pay
Use numbered lists to present ordered information.
For example, step-by-step instructions to complete a task:
- This is step 1
- Here's step 2
- And now step 3
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:
|Monday to Friday||9am to 5pm|
|Saturday||10am to 4.30pm|
Shoutboxes look like this. You can use them to highlight important information.
Avoid overusing shoutboxes, as this makes them less noticeable.
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.
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 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.
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.
Adding links, documents, images and videos
This section includes: links, documents, images, videos and other media
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.
Do not signpost to further information without context, e.g. 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.
How to publish information
Publish information as webpage content (HTML) rather than files (e.g. 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.
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.
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.
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: acronyms, addresses, ampersands, capitalisation, dates and times, hyphens, italics, money and fees, numbers and ages, percentages, quotations, semi-colons, singular and plural, units of measurement, web terms
Acronyms or initialisms are when you combine the first letters of several words to create a new word.
- Multi-Agency Safeguarding Hub becomes MASH
- CYP instead of Children and Young People
How to introduce an acronym or initialism on a page for the first time:
- Write the original term in full with the acronym or initialism in brackets, e.g. ‘Adult and Community Services (ACS)’
- You could then refer to 'ACS' for the rest of the page
When writing addresses use the format:Suffolk County Council,
8 Russell Road,
Do not use ampersands. people find them hard to read. They also sound more confusing being read by screen-reading software.
Write 'Roads and transport' not 'Roads & transport'.
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, e.g. 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'.
Examples of words on suffolk.gov.uk that should include hyphens:
Words that shouldn't have hyphens:
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'.
Write percentages using the format '95%', not 'percent' or 'per cent'.
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.”
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 …’
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'.
When linking to a website use the format 'suffolkjobsdirect.org'. Do no include 'http://www.' prefix characters or any unnecessary slashes.
- 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
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.
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.
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.
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.
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.
Write times as '2pm' rather than the 24-hour clock '14:00'. It's easier to understand using a screen reader.
Explain if non-English language is used in a page for any reason.
Use 'and' rather than the '&' symbol.
Example: 'Roads and transport', not 'Roads & transport' which a screen reader who read as 'roads ampersand transport'.
Search Engine Optimisation (SEO)
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, e.g. 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, e.g. 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, e.g. 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. E.g. 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.
Editing, proofreading, spelling and grammar
This section includes: editing, proofreading, misspellings, homophones, apostrophes, other common mistakes
Editing and proofreading tips
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
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.
Write using British English, not American English.
- ‘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.
These are words that are pronounced and spelled similarly, but have different meanings.
Make sure you’re using the correct versions of the following:
This is when you use additional words that are unnecessary.
Examples of tautologies are:
- new innovation
- mutual co-operation
- past experience
- honest truth
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.
Managing your content
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 firstname.lastname@example.org 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
- 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.
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 email@example.com.
Suffolk County Council
- Contact us
- How to find us
- Online services
- Severe winter weather information and services
- Give feedback or make a complaint
- Make a freedom of information (FOI) request
- Our website and social media
- Secure emails
- Apply for permission to film in Suffolk
- Terms and conditions
- Privacy and data protection
- Privacy notice
- Terms and conditions for domain names