Content types

When and how to use the 伊人直播 formats.

Choosing the right format

It鈥檚 important to choose the format that fits your content. Do not base your decision on how a format looks.

This is because:

  • if your content is in the wrong format, users will not be able to find it
  • we鈥檙e working on grouping formats by purpose and user need to allow users to find content more easily
  • it could wrongly go into history mode

Call for evidence

There could be legal consequences if you use a call for evidence content type when you are actually carrying out a consultation. You should be sure that you are carrying out a call for evidence rather than a consultation聽 before you upload. You may wish to refer to the聽 Consultation Principles or speak to your legal advisers about this.

Do not use for

  • consultations
  • when you need to publish an outcome

Creating a new call for evidence

Find out how to create and update a call for evidence in Whitehall publisher.

Case study

Use case studies for real examples that help users understand either:

  • a process that鈥檚 covered on 伊人直播 (for example it shows someone鈥檚 experience of taking part in a particular government programme)
  • an important aspect of government policy that鈥檚 covered on 伊人直播 (for example it shows someone鈥檚 personal experience of a policy problem the government is trying to solve)

Do not create a case study if:

  • it鈥檚 just about promoting your organisation - this just creates 鈥榥oise鈥 and makes it harder for users to find the practical information they need
  • it does not relate directly to guidance or policy content on 伊人直播, or add something really important to it
  • it鈥檚 not going to be permanently useful (situations with only a temporary interest are better dealt with in a news story or press release)
  • it鈥檚 similar to an existing case study - this just creates 鈥榥oise鈥 and confuses users

Remember, most users just want practical information. Case studies can be counter-productive as they鈥檙e just something else for the user to read, and can complicate search results. It鈥檚 often best to concentrate on getting the wording of the guidance right instead.

Creating a new case study

Find out how to create and update a case study in Whitehall publisher.

Example

View a good example of a case study.

Writing and formatting case studies

All content should follow the Government Digital Service (GDS) style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are some additional things you need to consider when writing a case study.

Format

A case study can be either a first-person account or a third-person account with quotes from the person it鈥檚 about.

Case studies can be in video form.

Title

Summarise the point of the case study.

Do not use the words 鈥榗ase study鈥 in the title: they appear on the page automatically.

Good example: UK money helps to build new homes in Darfur

Bad example: After the war

Summary

This should outline what happened, why and the result.

Good example:

鈥楾he war in Darfur left many people without homes. The government gave the Sudanese government 拢x money and 500 builders to help build homes for 1,000 families.鈥

Body copy

Do include:

  • information about how the case study supports a particular policy (include links to relevant pages)
  • stats and facts: how many people this will help, how much money is going where etc
  • the human element: who is benefiting and how

Do not include:

  • too much detail about the past
  • too many quotes (unless it鈥檚 a straight interview)

Example: The 7-year war in Darfur (2003 to 2010) left x people homeless. Despite the ceasefire in 2010, the region is still unstable and work to rebuild homes is slow.

The government sent [building company, builders etc] to Darfur in June 2011. In 6 months they built 50 homes, which will house 200 people including 130 children.

George, husband and father of 4 children, said:

鈥淚t has made such a difference to our lives. My wife was ill and our children were getting sick. We were crammed into a tiny house with 5 other families. The living conditions were awful. Now we have a clean house to ourselves. The children share a room but they love the space and get up to mischief.鈥

Lead image

Using a lead image is optional for a case study. The lead image is shown at the top left-hand side of the published case study. To use a lead image, either upload an image and select it as the lead image or use the default image for your organisation.

You can change the default image on your organisation page. If your document also has an image in the body text, you must upload the lead image first.

Consultation

Use for:

  • consultations (officially 鈥榙ocuments requiring collective agreement across government鈥)
  • requests for people鈥檚 views on a question

Do not use for:

  • documents that should be added to an existing consultation (such as supporting or outcome documents)
  • informal 鈥榗onsultations鈥 like surveys

Creating a new consultation

Find out how to create and update a consultation in Whitehall publisher.

Example

View a good example of a consultation.

Writing and formatting requirements for consultations

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are also some further points you need to think about when writing a consultation.

Title

Summarise the point of the consultation.

Do not use the word 鈥榗onsultation鈥 in the title: it appears on the page automatically.

Body copy

Do:

  • give a short, succinct account of what you are asking people about
  • keep the body copy to under 100 words

Do not:

  • include publication or response dates as they鈥檙e inserted automatically and say who the consultation is aimed at
  • include jargon, even if you think the intended audience will understand it

Attachments

When you upload an attachment, it will automatically show the front page of the consultation.

Learn more about adding attachments.

When a government response is available, upload relevant files to the consultation page so that the whole consultation is findable at the original URL.

Public feedback (optional - can be added after consultation closes)

Do use the summary or body copy to:

  • say how many responses were received
  • the type of responses received (for example from members of the public, small businesses, large businesses, local government organisations, trade unions etc).

Do not:

  • try to summarise what the feedback says - just upload the actual feedback
  • include dates in the copy - the publication date is inserted automatically

Final outcome (add once the government response is ready)

Do:

  • use the summary or body copy to describe briefly what form the government response takes
  • add only documents that form part of the government鈥檚 initial response to the consultation (usually just the official response document plus a final impact assessment, if there is one)

Do not:

  • describe what the response actually said - that information goes in the attachment
  • do not attach documents with a lifespan longer than the consultation, like implementation plans or new guidance - create a separate publication page instead
  • add more information or attachments to the page after the initial government response has been published

Corporate information: about our services

Use for:

  • service level agreements and service standards

Do not use for:

  • your general approach to customer service
  • general information about your services

If you create an 鈥榓bout our services鈥 page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

It鈥檚 designed for specific information about your service level agreements. For general information about your services use the services and guidance links or 鈥榓bout us鈥 page.

To explain your approach to customer service, use the complaints procedure instead.

Creating a new 鈥榓bout our services鈥 page

鈥楢bout our services鈥 is created as a corporate information page.

Find out how to create and update 鈥榓bout our services鈥 in Whitehall publisher.

Writing and formatting requirements for 鈥榓bout our services鈥 pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines.

Corporate information: accessible documents policy

Organisations who publish PDFs and other non-HTML documents on the main 伊人直播 website must publish an accessible documents policy.

The policy should cover:

  • what document types your organisation publishes
  • how accessible your documents are
  • how users can request accessible formats

The policy should be owned and maintained by the person in charge of publishing in your organisation.

If you create an accessible documents policy, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new accessible documents policy

Find out how to create and update an accessible documents policy in Whitehall publisher.

Writing and formatting requirements for accessible document policies

Use this sample accessible documents policy to help you write yours. It explains what you need to cover and which forms of wording are legally required.

Corporate information: complaints procedure

Use for explaining:

  • what people can do if they have a problem with how the organisation has treated them
  • how to take an existing complaint further

Do not use complaints procedures to:

  • explain related background or procedures
  • describe internal procedures

If you create a complaints procedure, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation page and your 鈥榓bout us鈥 pages.

Creating a new complaints procedure

Find out how to create and update corporate information in Whitehall publisher.

Example

View a good example of a complaints procedure.

Writing and formatting requirements for complaints procedures

All content should follow the GDS style guide and Writing for 伊人直播 guidelines.

Complaints procedures also use specific headings and a set structure.

Types of complaints we can help with

Explain:

  • what type of complaints the organisation will look at
  • what type of complaints the organisation will not look at (for example because they鈥檙e handled in a different way)

Use bullet points where possible.

How to complain

Explain:

  • how to make a complaint - if there are different procedures for different types of complaint, consider creating separate subheadings for each
  • how to contact someone about the complaint

Do not:

  • duplicate information already on 伊人直播 (for example, if there鈥檚 a procedure for complaints about personal data which is covered on the 鈥楶ersonal information charter鈥 page, do not add it here too)

What happens next (optional)

Explain:

  • what happens when the organisation receives a complaint
  • when people can expect a response

If you鈥檙e not satisfied (optional)

Explain:

  • what to do if someone is not satisfied with how the organisation has handled a complaint (for example, ask their local MP to refer it to the relevant Parliamentary ombudsman)

Service standards (optional)

If the organisation has a formal service standards document, attach it here.

Corporate information: equality and diversity

Use for:

  • publishing equality information and documentation, as required by law for some public bodies - if you鈥檙e unsure about your obligations, talk to the relevant people in your organisation

Typically, public bodies publish:

  • equality objectives
  • reports showing how the organisation is meeting its equality responsibilities

Do not use for:

  • guidance or general information about equality and diversity

If you create an 鈥榚quality and diversity鈥 page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new equality and diversity page

Find out how to create and update corporate information in Whitehall publisher.

Example

View a good example of an equality and diversity page.

Writing and formatting requirements for equality and diversity pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Equality and diversity pages also use specific headings and a set structure.

Summary

Use this text:

As a public body, we publish regular information about what our equality objectives are and how we鈥檙e meeting them.

Body copy

Avoid jargon, vague aspirational statements (such as 鈥榳e鈥檙e committed to鈥, 鈥榳e鈥檙e proud of鈥), and general statements about how important it is to be inclusive.

Do not provide information directed at staff (such as how to join support networks). Put that on your intranet.

Equality objectives

Say what you publish and how often you publish it.

Good example:

We publish:

  • equality objectives (every 4 years)
  • reports showing how we鈥檙e meeting our equality responsibilities (once a year)

Then attach or link to the relevant publications.

Publications that are produced specifically to meet equality objectives (usually the objectives publication and annual reports) should be attached to the page. Only attach the latest versions: older versions should be archived.

If there are other publications you want to mention as part of how the organisation meets its equality objectives (such as a staff survey), add a link to it.

Organisations we work with (optional)

If other organisations are helping you to meet your equality objectives (for example, Business in the Community, Stonewall, Business Disability Forum), list them here.

Equality contact (optional)

If the organisation has a specific contact for questions or comments about its equality work, you can give their contact details here.

Only include them if they are different from the organisation鈥檚 general contact details.

Corporate information: our governance and memberships

If your organisation is a department or agency, you can create a governance page to show who is ultimately responsible for making sure the organisation:

  • does what it鈥檚 supposed to do
  • meets its legal obligations
  • identifies and manages risks

You should create a membership page instead if your organisation has a board of experts, committee or council.

Stick to the most senior governance boards and committees. A typical page will cover:

  • the organisation鈥檚 most senior decision-making body (often known as the governing board)
  • the executive board and/or management board, if there is one (usually the governing board plus a few other senior officials, minus any non-executive directors)
  • the main body responsible for risk management and corporate governance within the organisation (often known as the audit and risk committee)
  • top-level governance groups of very senior officials put together to oversee the organisation鈥檚 top few projects (there should only be a handful of these, if any - the idea is to represent only very significant projects like major reorganisations of widely accessed public services)

Do not use it for:

  • explaining decisions or processes
  • outlining strategies
  • describing how audits or risks are assessed

If you create a governance or membership page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new governance or membership page

Find out how to create and update a governance or membership page in Whitehall publisher.

Examples

View a good example of a governance page.

View a good example of a membership page.

Writing and formatting requirements for governance and membership pages

All content should follow the GDS style guide and writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are also some additional considerations you need to think about when writing a governance or membership page.

Body copy

Use the first paragraph to expand on the summary and explain what your governance boards and committees do.

Then, for each of the governance boards or committees you鈥檙e covering:

  • create a separate subheading
  • explain what it does (use bullet points if possible)
  • attach any terms of reference documents (use a publication box attachment)
  • attach minutes from recent meetings (attach the most recent as a publication box attachment and the others as inline style attachments)
  • link to the National Archives for minutes more than a year old (use this text for the link: 鈥楽ee the National Archives website for minutes from June 2013 and earlier鈥)
  • list the board or committee members (just names and job titles - use bullet points)

Corporate information: energy use

Only create an 鈥極ur energy use鈥 page if the organisation collects and publishes regular data about its energy use. If you create an energy use page, a link to it will automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

If it does, use it for:

  • information about the organisation鈥檚 energy use - nothing else

Do not use for:

  • guidance on how to reduce energy consumption or general information about carbon emissions

Creating a new energy use page

Find out how to create and update corporate information in Whitehall publisher.

Writing and formatting requirements for energy use pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Energy use pages also use specific headings and a set structure.

Summary

Adapt this text:

Details of [organisation name]鈥檚 energy use at our headquarters building (or say which building(s) you鈥檙e providing information about).

Energy use data

Link to data on the organisation鈥檚 energy use. This might be:

  • live data hosted on an external website
  • data files hosted on
  • data files attached to the page

Do:

  • say which building(s) you鈥檙e providing data for

Do not:

  • provide information on the size and space of rooms

Display energy certificates (optional)

If the organisation has a Display Energy Certificate, you can attach it directly to the page.

What we鈥檙e doing to reduce our energy use (optional)

Do:

  • use bullet points
  • give brief details of specific measures, not general aspirations
  • attach any documents setting out the organisation鈥檚 energy-saving commitments in detail (for example a 鈥楪reening government鈥 publication)

Corporate information: media enquiries

Use for:

  • telling journalists who they should contact with specific types of enquiry - only include people who act as the initial point of contact for journalists

Do not create a media enquiries page if:

  • you only have one or 2 contact numbers for media enquiries - just add the contact details to the organisation page

If you create a media enquiries page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a media enquiries section

Find out how to create and update media enquiries in Whitehall publisher.

Example

View a good example of a media enquiries page.

Writing and formatting requirements for media enquiries

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Media enquiries also use specific headings and a set structure.

Summary

Make it clear that the contact details on this page are for journalists only.

Adapt this text: Contact our press team if you鈥檙e a journalist with a media enquiry or interview request.

Body copy

Group media contacts according to area of responsibility (using this format means that media contacts can be entered into Whitehall publisher correctly and reused across the site).

For example, if the Ministry of Justice (MOJ) had 4 press officers working across 2 different areas, their 鈥楳edia enquiries鈥 page would be organised like this:

Criminal justice desk

Contact the criminal justice desk with questions about government policy on criminal justice cases.

Media officer name, job title

Telephone:

Media officer name, job title

Telephone:

Prisons desk

Contact the prisons desk with questions about government policy on life in prison.

Media officer name, job title

Telephone:

Media officer name, job title

Telephone:

Out of hours

Contact the duty officer on [phone number].

Corporate information: personal information charter

Use to:

  • set out the organisation鈥檚 personal information charter (the principles it uses when collecting, holding and processing service users鈥 personal information, and how service users can help keep their details up to date)
  • explain the organisation鈥檚 data protection policy and tell people where to send subject access requests.

Contact your organisation鈥檚 data protection officer if you鈥檙e not sure which parts of the page you should include.

If you create a 鈥榩ersonal information charter鈥 page, a link to it will appear automatically beneath the 鈥榡obs and contracts鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new personal information charter

Find out how to create and update a personal information charter in Whitehall publisher.

Example

View a good example of a personal information charter.

Writing and formatting requirements for personal information charters

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Personal information charters also use specific headings and a set structure.

Summary

Adapt this text: This charter sets out what you can expect from us when we ask for, or hold, your personal information. It also covers what we ask from you to help us keep your information up to date.

Your privacy

Explain:

  • the principles the organisation follows when handling service users鈥 personal data
  • what you ask service users to do to help you keep their personal information accurate and up to date

Use bullet points where possible.

Data protection policy (optional)

Explain:

  • how the organisation meets its obligations under the Data Protection Act 1998

Be concise and use bullet points where possible. If it鈥檚 a long policy, attach it instead.

Data protection: find out what personal information we hold about you (optional)

Use the phrase 鈥榮ubject access鈥 for search purposes and explain:

  • how to make a subject access request under the Data Protection Act 1998
  • any fees that may be charged
  • the time limit for responding to subject access requests, and what the organisation will do if it looks like it will take longer

You should also:

  • attach the organisation鈥檚 subject access request form or standard letter (if it has one)
  • link to the organisation鈥檚 entry in the register of data controllers for people who want to find out more about how the organisation handles personal data

Corporate information: procurement at [organisation name]

Use for:

  • letting businesses know, as clearly and concisely as possible, how to start selling goods and services to your organisation
  • linking to concrete opportunities

Do not create a procurement page for:

  • guidance on invoicing (suppliers can get these details from your purchasing orders)
  • anything about spending data (that鈥檚 covered elsewhere on 伊人直播)
  • providing lots of information about processes
  • general information about government procurement policy 鈥 for example, the obligation to publish details of central government contracts (that鈥檚 covered elsewhere on 伊人直播)

Explain the process in neutral terms: do not attempt to 鈥榮ell鈥 the organisation as a business partner.

Include just enough to let potential suppliers take the initial step (do not provide any more detail than this 鈥 suppliers will be given more detailed information as they move through the procurement process).

If you create a procurement page, a link to it will appear automatically under the 鈥榡obs and contracts鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new procurement page

Find out how to create and update a procurement page in Whitehall publisher.

Example

View a good example of a procurement page.

Writing and formatting requirements for procurement pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Procurement pages also use specific headings and a set structure.

Summary

Use this text for the summary: Supplying goods and services to [organisation name].

Doing business with [organisation name] (mandatory)

Tell people what to do if they want to become a supplier. Depending on the organisation, this might mean:

  • linking to the place where your contracts are advertised (for example, Contracts Finder)
  • explaining how to sign up to the organisation鈥檚 tendering system
  • providing an email address for procurement enquiries

Standard supplier terms and conditions (optional)

If the organisation uses standard supplier terms and conditions, you can attach this directly to the page and use Markdown to insert a link to it.

[Organisation name] procurement policy (optional)

If your organisation has an official procurement policy, attach it directly to the page and use Markdown to insert a link to it.

Procurement complaints (optional)

Tell people what to do if they have a complaint about how the organisation has dealt with them as a supplier. Only include this if it鈥檚 different from the organisation鈥檚 general complaints procedure.

Final paragraph (optional)

If the organisation publishes information on how it鈥檚 improving procurement practices (for example, sustainable procurement commitments or a small and medium-sized enterprise (SME) action plan you can link to it here.

Link to this information rather than including it on the page: that way the procurement page stays focused on practical guidance for potential suppliers.

Corporate information: publication scheme

Use for:

  • listing the classes of information that the organisation makes available, as required by the Information Commissioner鈥檚 Office (ICO)

If you create a 鈥榩ublication scheme鈥 page, a link to it will appear automatically beneath the 鈥榡obs and contracts鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new publication scheme

Find out how to create and update a publication scheme in Whitehall publisher.

Example

View a good example of a publication scheme.

Writing and formatting requirements for a publication scheme

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Publication scheme template

Publication schemes follow a template set by the ICO.

Throughout, replace the highlighted text with your department or organisation鈥檚 name or acronym, the relevant series link or filtered search link, or the appropriate external URL.

You can make minor amendments to the text and add or delete links and categories where these apply to your organisation.

This publication scheme specifies the categories of information that the department and its agencies regularly publish and explains how to get that information.

You can find specific documents for this department using the publication search.

If the information you want is not routinely published, you can make a request for it under the Freedom of Information Act.

You can also search through previous responses to Freedom of Information requests (or amend this filtered search so it returns results for your organisation alone).

Who we are and what we do

This information covers our organisational details, structures, locations and contacts.

This includes:

What we spend and how we spend it

This is where we publish financial information about projected and actual income, expenditure, procurement, contracts and financial audits. This includes:

  • departmental financial statements, budgets and variance reports, published by HM Treasury
  • department spending for transactions over 拢25,000 (create your own document series to collate these and link to it)
  • any contracts and tenders worth over 拢10,000 (create your own document series to collate these and link to it)
  • any government procurement card spend over 拢500 (create your own document series to collate these and link to it)
  • our capital programme (create your own document series to collate these and link to it)
  • our spending reviews (create your own document series or filtered search to link to it)
  • the
  • our ministers鈥 allowances and expenses (create your own document series to collate these and link to it)
  • our senior staff and board members鈥 allowances and expenses (create your own document series to collate these and link to it)
  • our senior staff pay and grading structures (link directly to these on 伊人直播, or to relevant data.gov information)
  • our junior staff pay and grading structures (link directly to these on 伊人直播, or to relevant data.gov information)
  • our senior advisers鈥 salaries and salary ranges (link directly to these on 伊人直播, or to relevant data.gov information)
  • our procurement procedures
  • our financial statements for projects and events (remove this if not applicable, or create a series to collate these and link to them)
  • internal financial regulations

What our priorities are and how we鈥檙e doing

This category covers departmental strategies and plans, performance indicators, audits, inspections and reviews, including:

  • our
  • our strategic plans (link directly to the latest of these, or to a series collating them)
  • our current business plan
  • our annual report (link to your latest annual report, or your series collating your annual reports)
  • internal and external performance reviews (create one or more document series collating your performance reviews)
  • departmental performance reports to Parliament (create a document series to collate these and then link to it)
  • our inspection reports (create a series to collate these and then link to it)
  • the impact assessments we have made
  • the privacy impact assessments (create and link to a document series or a filtered search) we have made
  • our service standards (link to your service standards publication or series collating them)
  • statistics produced by the department

How we make decisions

This is where we publish details of our decision-making processes and records of our decisions. These include:

Our policies and procedures

This category covers our protocols, policies and procedures for providing services, and responsibilities, including:

  • how we conduct departmental business
  • delivering our services (possibly a single document, or create a document series to link to; this could be combined with 鈥榗ustomer service standards鈥, below)
  • recruiting and employing staff
  • customer service standards (possibly a single publication; or create a series of these to link to)
  • records management and personal data policies
  • charging regimes and policies (include a link to this if details are not already covered within the detail on the publication scheme page itself)

Lists and registers

Publish details of the department鈥檚 public registers, asset registers and disclosure logs, including:

Responsibilities

Lead with 鈥榃e are responsible for鈥 and bullet a list of your responsibilities. Keep them active, clear and not too detailed 鈥 you can do that in your policies.

Use a maximum of 7 bullets.

Services we offer (optional)

Information about the services the department provides including leaflets, guidance and newsletters:

  • regulatory responsibilities (probably single document with acronym)
  • services for public authorities (create document series with acronym)
  • services for industry (create document series with acronym)
  • services for other organisations (create document series with acronym)
  • services for the public (create document series with acronym)
  • fee-based services (create document series with acronym)
  • circulars (create document series with acronym, or named series which would not need an acronym)
  • leaflets, booklets and newsletters (wait, as new content types may be introduced for these)

Corporate information: research at [organisation name]

Use for:

  • providing information about what research you plan to publish and when (if the organisation publishes a lot of research)

Do not create a research page:

  • if the organisation does not have a significant research programme
  • to provide style guides or information for authors producing research reports on behalf of your organisation (send them this information directly when you commission the report)
  • to gather customer feedback (do that at the end of the service)

If you create a research page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new research page

Find out how to create and update a research page in Whitehall publisher.

Example

View a good example of a research page.

Writing and formatting requirements for research pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Research pages also use specific headings and a set structure.

Summary

Adapt this text: Our research programme aims to help us develop policy that鈥檚 informed by evidence, and to help us understand the needs of service users.

Research publications

Link to where the organisation鈥檚 research publications are published on 伊人直播. Usually this means a linking to a search results page, filtered by department and 鈥楻esearch and analysis鈥 publication type.

For example the Department for Work and Pensions (DWP) might link to their 鈥楻esearch and analysis鈥 publications using this url: /government/publications?keywords=&publication_filter_option=research-and-analysis&topics%5B%5D=all&departments%5B%5D=department-for-work-pensions

When you copy the url for your organisation from 伊人直播, do not forget to remove the end of the url (from 鈥&publication鈥 onwards). Otherwise it will only show publications within a certain date range.

You can also add a link to the organisation鈥檚 older research publications on the National Archives site.

Forthcoming research publications

List the major items of research you鈥檙e planning to publish for up to the next 12 months. Use a list format rather than a table. Order it so that the closest to publication is at the top - for example:

  • Mandatory work activity: evaluation (1 December 2020)
  • Measuring attitudes to age in Britain (10 April 2021)
  • Work Programme first phase: evaluation of qualitative research (25 June 2021)

Once something has been published, remove it from the list.

Our research programme (optional)

Briefly explain what the organisation is trying to achieve through its research work in no more than a few sentences. You might want to cover:

  • the scope of the organisation鈥檚 research work
  • criteria for commissioning research
  • quality assurance or review procedures
  • standards and ethics

If the organisation has a formal research commissioning policy or similar publication, you can attach it to the page here.

Research contracts (optional)

You can use this section to let people know how to become a supplier of research services to your organisation.

Do not list individual opportunities: just let people know where contracts are listed (Contracts Finder for a lot of government organisations).

Do not duplicate substantial amounts of content from your 鈥楶rocurement at [organisation]鈥 page.

Corporate information: statistics at [department]

Use 鈥楽tatistics at [department]鈥 if you want to list your statistics collections.

You can also link to the list of statistics tagged to your department.

If you create a statistics page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Example

View a good example of a statistics page.

Corporate information: terms of reference

The terms of reference of an organisation or group describe its aims, structure and how it will work. They outline the objectives of the group, and the roles and responsibilities of those involved.

Have a look at the Committee on Radioactive Waste Management as an example.

If you create a terms of reference page, a link to it will appear automatically under the 鈥榗orporate information鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Corporate information: working for [department]

Use for describing:

  • what sort of roles you might recruit for
  • benefits to working for your department 鈥 travel, holiday, pension
  • training and development opportunities
  • benefits of working for the civil service 鈥 sports etc
  • a link to civil service recruitment or other relevant recruitment websites

If you create a 鈥榳orking for鈥 page, a link to it will appear automatically under the 鈥榡obs and contracts鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new working for page

Find out how to create and update a working for page

Example

View a good example of a working for page.

Writing and formatting requirements working for pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Corporate information: Welsh language scheme

Use for:

  • explaining the organisation鈥檚 Welsh language scheme, if it has one

If you create a Welsh language scheme page, a link about publishing in Welsh will appear automatically beneath the 鈥榡obs and contracts鈥 heading on your organisation and your 鈥榓bout us鈥 pages.

Creating a new Welsh language scheme page

Find out how to create and update a Welsh language scheme page in Whitehall publisher.

Example

View a good example of a Welsh language scheme page.

Writing and formatting requirements for Welsh language scheme pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Welsh language scheme pages also use specific headings and a set structure.

Summary

Use this text:

We treat the English and Welsh languages equally when conducting public business in Wales.

Body text

Adapt this text:

Our Welsh Language Scheme explains what [organisation name] does to make sure the English and Welsh languages are treated equally when we provide public services in Wales.

Add the actual scheme as an attachment to the page (English version then Welsh version).

Do not include any other information.

Detailed guide

Detailed guides tell users the steps they need to take to complete a clearly defined task. They are usually aimed at specialist or professional audiences.

Use this format for content that is regularly updated, for example if the process to complete a task changes.

A detailed guide should:

  • answer a specific, task-oriented user need
  • be factual guidance the government has a duty to provide, not advice

Audience

This content is aimed at practitioners, for example teachers or accountants.

Content containing background information about why a user needs to complete a task or the history behind it should be in a policy paper.

Consider if the content should be in mainstream guidance instead.

Creating a new detailed guide

Find out how to create and update detailed guides in Whitehall publisher.

Example

View a good example of a detailed guide.

Writing and formatting requirements for detailed guides

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

When you are writing a detailed guide, there are also a few more things you need to think about.

Title

Make titles active if you use the page to do the thing (for example, 鈥楽ubmit statutory declarations鈥).

If the page is about doing the thing but you do it elsewhere, use the present participle (for example, 鈥楿sing and submitting statutory declarations鈥).

Use a colon as a separator, if you need one (for example, 鈥楥ontrolled goods: licences, sanctions and embargoes鈥).

If the guide does not involve a direct action and is information-led:

  • front-load the title with the most popular search terms
  • make sure the title provides a full context (use 鈥榞uidance for potato growers鈥, not 鈥榩otatoes鈥)

If there are a number of guides with a repeated phrase in the title (for example, Manufactured goods: automotive, Manufactured goods: electronic), change it so the most important information or phrase comes first, like 鈥楢utomotive sector: import and export regulations鈥 or 鈥楥hemical sector: import and export regulations鈥.

Summary

Use the summary to explain the point of the guide, what it will help users do or understand, and who it鈥檚 for. Remember:

  • you can use 鈥楢n introduction to鈥︹ if it鈥檚 an introduction (for example, the guide is short and links to other sources for the main information)
  • using 鈥楬ow to xxx鈥 and 鈥楩ind out xxx鈥 etc is good

Example:

Title: Organic produce: how to become an importer

Summary: Find out which organic products can be imported into the UK, how to register as an importer and how to get import authorisation.

Structure

Do:

  • make section titles active (so, 鈥楢pply for a licence鈥 not 鈥楢pplying for a licence鈥)

Do not use:

  • technical terms in section titles unless unavoidable - and then only if you鈥檝e already explained them
  • 鈥榠ntroduction鈥 as your first section 鈥 users do not want an introduction, they want the most important information
  • questions in section titles
  • FAQs - you will not need them if your content is concise, well structured and written in plain English
  • 鈥榳e鈥 - users can arrive at your page from anywhere, so 鈥榳e鈥 may not be clear to them

Document collection

Use a document collection for grouping related documents on a single page:

  • for a specific audience
  • around a specific theme or topic

A collection could be used to publish:

  • a set of forms
  • publications in the same series
  • a mix of document types related to the same task or event

You can add a document to more than one collection.

Do not create a collection:

  • for documents that users do not need, or would not expect, to find together
  • in place of a records management system
  • for a single document
  • for editions of the same publication (these should be multiple attachments on a single publication page)

Creating a new document collection

Find out how to create and update document collections in Whitehall publisher.

Structuring a document collection

To help users find specific content on your collection page, you can:

  • change the default headings to something more descriptive of the content you鈥檙e linking to, for example 鈥楢nnual reports 2015 to 2020鈥
  • add a one-line introduction under a heading, for example 鈥楾hese reports give an account of activity and services for each year, including financial statements.鈥

Example

View a good example of a document collection.

Events

Use for:

  • future events that your organisation is holding
  • past events, when you need to update the event to include things like a presentation

Do not use for:

  • events that staff from your organisation have attended or are going to attend

Creating a new event

Create each event using the news story content type. If your organisation has more than one event, add them to a document collection. The document collection can show all future and past events. Past events can also be taken down unless you want to keep them to add presentations and videos.

As these are events, the style does not have to follow the standard guidance for news stories and document collections. For example, you can use the 鈥楧etail鈥 section on the document collection page for an overview of the events programme and details of how to book.

Find out how to create and update an event page (news story content type) in Whitehall publisher.

Find out how to create and update document collections in Whitehall publisher.

Fatality notice

Use for announcing the death of a member of the armed forces or Ministry of Defence (MOD) personnel.听

These appear automatically on the MOD鈥檚 British fatalities Fields of operation page when they鈥檝e been published.

After publishing a fatality notice, you can add obituaries and tributes to the deceased person on the same page.

Do not publish a news story which duplicates the fatality notice.听

Example

View a good example of a fatality notice.

Creating a new fatality notice

All content should follow the Government Digital Service style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Include an image of the deceased person if you have one.

Title

Include the name and title of the person who has died.听

Summary

Use the summary to confirm the death and offer condolences from the MOD.

Body copy

In the body copy, write:

  • the deceased person鈥檚 name and title
  • the incident in which they died聽
  • the location of the person鈥檚 death (if this has been cleared for release)聽

When you have more information, you can add:

  • an image of the deceased person
  • a caption underneath the image with the deceased person鈥檚 name and title
  • an obituary

The obituary can include:

  • details about the deceased person鈥檚 life and years of service
  • any additional images of the deceased person聽

To add an image:

  1. Save your draft.

  2. Go to the 鈥業mages鈥 tab.

  3. Select 鈥楥hoose file鈥 and then 鈥楿pload鈥.听

  4. Copy the image markdown code.听

  5. Paste the markdown code into the body text where you want the image to appear.听

  6. Add a caption and alt text to the image that describes what the image shows.听

Include copyright information after the description. If the image is not by the MOD, add 鈥楢ll rights reserved鈥. If the image is by the MOD, add 鈥MOD Crown Copyright鈥.

For example, Lance Corporal James 鈥楯ay鈥 Bateman (All rights reserved.)

You can also include quote tributes from those who knew them, for example:

  • armed forces colleagues
  • family
  • friends
  • an MP, for example the Secretary of State for Defence

Field of operation

Select the country the person died in.听

Roll call info

Include a brief summary of the deceased person鈥檚 name and title, the incident in which they died, and the date on which they died. This will display above the link to the fatality notice on the Fields of operation page.听

Example

View good examples of roll call info.

Casualties

List any people who died during the same incident as separate links underneath the roll call info.听

Include in the link text:

  • the names and titles of those who have died
  • their regiment, battalion or air wing (if cleared)
  • their age聽
  • where they鈥檙e from

Group

The group format is used for policy advisory groups and other types of groups in government. You need to Contact GDS to get approval to set up a group page.

Use group pages for:

  • explaining very briefly what the group does or is responsible for

Do not use them to:

  • highlight a particular government scheme or project - if this is the purpose of the group, promote the relevant content pages rather than the group page
  • create an organisation homepage where everything about the group and the subject area it鈥檚 responsible for is collected in one place
  • explain the internal structure of government

Creating a new group page

Find out how to create and update a group in Whitehall publisher.

Example

View a good example of a group page.

Writing and formatting requirements for groups pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are also some additional considerations you need to think about when writing a group page.

Title

Use the name of the group but do not include the acronym.

Summary

Do:

  • use a single sentence to describe what the group does
  • include who the group reports to, if it鈥檚 a policy advisory group (if there鈥檚 not enough space, add it to the 鈥榬ole鈥 section)

Do not:

  • use technical terms or the group acronym unless there is solid analytics evidence that users search for these terms

Body copy

Do not use more than 6 H2 subheadings to the detail section unless you are writing about a policy advisory group

You can create an inline link to the most important publication, detailed guide or document collection related to the group鈥檚 work - but only if the user has a call to action to follow. Do not attach the publication directly to the page (as you would for minutes) but link to the publication page.

Role

Do:

  • add as an H2 subheading if more detail is needed on the role of the group
  • use this section to explain why the public may need to contact the group (non-policy advisory groups only)
  • use this section to say who the group reports to if this has not been included in the summary (policy advisory groups only)

Do not:

  • write more than 2 sentences
  • write more than 30 words in total

Contact

Add an email address to this field so that users can contact the group. The email address will appear below all the other sections.

Other contact details

If there are other contact details, add a single H2 subheading (for example, 鈥楢ddress and phone number鈥 or 鈥楽ecretariat address鈥) at the end of the group page.

Terms of reference (policy advisory groups only)

Attach the group鈥檚 terms of reference to the page - use a publication box attachment.

Membership (policy advisory groups only)

Do:

  • begin with 鈥楥urrent members are:鈥
  • list the chair of the group first, with 鈥(Chair)鈥 in brackets after their name
  • follow this with a bullet point list of members
  • only include a member鈥檚 name, job title and the organisation they represent (if it鈥檚 not obvious)

Do not:

  • include titles or honorifics

Minutes (policy advisory groups only)

Minutes should only be added by policy advisory groups. Other groups should only provide minutes if a genuine user need for them can be demonstrated.

Do:

  • attach minutes directly to the page - do not publish them as publications and then link to them
  • attach the most recent minutes as a publication box attachment
  • attach other minutes using inline attachments
  • use this format for the link text: 鈥19 January, 2020: minutes鈥
  • link to the National Archives for older minutes (use this format for the link text: 鈥楽ee the National Archives website for minutes from June 2013 and earlier鈥)

Do not:

  • attach more than the previous 6 months of minutes

Code of conduct (policy advisory groups only)

If a policy advisory group has a formal code of conduct, you can attach it to the page here. This is optional and does not have to be included on the page.

Licence

Use for:

  • telling users how to apply for a licence

You鈥檒l see the word 鈥楲icence鈥 above the page title and it鈥檒l be listed on the 鈥楩ind a licence鈥 tool.

Creating or updating licence pages

Read the guidance on publishing licence pages.

Writing and formatting requirements for licence pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Manual

Manuals are a browsable format that are generally created for specialist users who are familiar with a topic.

They also have features which make them suited to long or complex legal documents with named or numbered chapters or clauses. They can be used instead of a lengthy PDF.

Manuals have:

  • at least 2 layers of navigation
  • chapters with plain English summaries that appear in search results
  • the option to create and link to legislative lists (named clauses and sub-clauses)
  • a contents page listing the sections (or chapters) of the manual
  • section pages listing all sub-sections - these can be 鈥榦pened鈥 individually or all at once
  • change notes for recording updates
  • the ability to add footnotes

Use for:

  • content that requires at least 2 levels of hierarchy (ie it is broken down into sections and sub-sections)
  • complex content which includes named chapters, clauses or sub-sections that are referenced regularly by the intended audience (for example legislative documents, regulations)
  • content that is too long to be easily readable in an HTML publication or detailed guide
  • content users think of as a single body or document
  • legal or guidance documents which need to be browsable
  • content that has a valid user need

Do not use for:

  • PDFs or documents that are published elsewhere on 伊人直播
  • internal guidance, unless there鈥檚 a legal requirement to do so (for example HMRC manuals)

Creating a new manual

You must contact GDS for permission to create a manual.

Find out how to request a new manual.

If a manual is agreed, you鈥檒l be given access to Manuals Publisher (which is similar to Whitehall publisher). Any training requirements you have will also be determined.

Once you鈥檝e got permission and access to Manuals Publisher, find out how to create a new manual.

Example

View a good example of a manual.

Writing and formatting requirements for manuals

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

News article: government response

Use for:

  • government statements produced in response to media coverage by the organisation鈥檚 press team (for example rebuttals, 鈥榤yth busters鈥 etc)

Do not use for:

  • statements issued to Parliament - use the speech format
  • speeches - use the speech format
  • press articles or letters to newspapers written by ministers - use the speech format

Creating a new government response

Find out how to create and update news articles in Whitehall publisher.

Example

View a good example of a government response.

Writing and formatting requirements for government responses

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are also some additional considerations you need to think about when writing a government response.

Title

Do:

  • use the title to summarise the government鈥檚 position

Do not:

  • start titles with 鈥楽tatement on 鈥︹ or 鈥楪overnment response to 鈥︹ - it takes up space without saying anything useful and makes it difficult to tell statements apart
  • include the name of the person making the statement in the title - it will appear on the page automatically

A good example:

Syria: international community must act as deaths reach 100,000.

Summary

Do:

  • expand on what you鈥檝e said in the title
  • indicate what you鈥檙e responding to

Do not:

  • repeat the title

Good example:

News reports on the scale of the tragedy show the need for all sides to respect humanitarian efforts and work towards a political solution.

Body copy

Make it short and to the point. Government responses tend to be shorter than press releases. They鈥檙e usually just a quote from the organisation spokesperson, so there鈥檚 usually no need for subheadings.

Lead image

All news articles have a lead image. The lead image is shown at the top left-hand side of the published news article.

The first image you upload is used as the lead image. If you do not upload an image, the default image for your organisation will be used. You can change the default image on your organisation page. If your document also has an image in the body text, you must upload the lead image first. If you then want to use your organisation鈥檚 default image, you will also need to upload it first.

News article: news story

Make sure your news story:

  • gives users information they can act on (for example a government grant scheme opening for applications)
  • gives information users would expect to get directly from the organisation rather than through the media (for example information about how changes to public services affect them as public sector employees)
  • includes information users need and cannot get from other sources
  • is genuine news content
  • adds something to existing content
  • is self-contained - it should be possible to delete it from the site without affecting anything else

Do not publish a news story if:

  • it鈥檚 mostly about putting the organisation鈥檚 views on record (it should probably be a press release or a 鈥楪overnment response鈥)
  • it鈥檚 duplicating a press release
  • it鈥檚 duplicating another organisation鈥檚 news story
  • it鈥檚 actually a general purpose content page
  • you鈥檙e just promoting the publication of other content (for example, statistics)
  • it鈥檚 duplicating a fatality notice

Creating a news story

Find out how to create and update a news story in Whitehall publisher.

Example

View a good example of a news story.

Writing and formatting requirements for news stories

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are also some additional considerations you need to think about when writing a news story.

Deciding what to publish

Most users will not look at news content - some news content gets as little as 2% of site traffic, and only a few get more than a third.

Be selective when deciding what to publish. Think about what users need to know rather than what the organisation would like them to see. You should:

Avoid duplicating other organisations鈥 news stories

Any duplication is very obvious on 伊人直播, so stick to your remit. If there鈥檚 more than one organisation with an interest in a topical issue, think about producing a joint story 鈥 it鈥檚 likely to have more impact.

But if 2 organisations are covering completely different angles and/or addressing different audiences, it鈥檚 okay to issue separate stories.

Make sure it鈥檚 information that users can act on (or cannot get from other sources)

For the most part, government is a source, not a provider, of news. That鈥檚 what media organisations do.

Content that鈥檚 about providing comment or explaining the government鈥檚 position on a matter of policy is more suitable for a press release. Content explains the government鈥檚 position in response to a news item should be published as a 鈥楪overnment response鈥.

News stories represent the organisation鈥檚 views at a particular moment in time: do not make changes after they鈥檙e published, unless it鈥檚 to correct an error.

Do not publish guidance in news stories or press releases

If you publish guidance in a news story or press release, it might confuse the user because it could:

  • conflict with guidance that鈥檚 already on 伊人直播
  • go out of date - this may cause users to act on something wrongly

You should use news stories to announce changes and link to the relevant guidance if you鈥檙e referring to something a user can act on.

Make sure it adds something to existing content

Do not publish news items just to provide a link through to other 伊人直播 content 鈥 it confuses user journeys and complicates search results, without adding any benefit for users.

Article length

There鈥檚 no lower limit, although the value of a story under 150 words should be questioned. News articles should be no longer than 750 words 鈥 with case-by-case exceptions (for example, some Budget pages).

Titles

What鈥檚 the story? Tell the story in a few words:

  • headlines: aim for 65 characters max
  • use a colon not a dash to separate: Google does not recognise dashes

鈥楳inister visits factory鈥 is not a story. 鈥楪reg Clark tells factory workers about workplace law reforms鈥 gives the reader a sense of what the story is about.

Avoid 鈥榯easing headlines鈥, puns or wordplay 鈥 these make your story hard for people to find. Use the words most people use for the situation. This helps your search ranking.

Avoid print conventions/鈥榡ournalese鈥, such as 鈥楳inister in youth homelessness bid鈥 (鈥榖id鈥 is used in print where headline space is in short supply).

Think about what happens in Little Red Riding Hood, then think what the headline should be:

Good example: 鈥楪ranny in near-death wolf escape鈥 Bad example: 鈥楪irl goes into forest, encounters problems鈥

Summary

Get across the main point of the story, expanding on what you鈥檝e said in the title. Use up to 160 characters including spaces: this is all people searching Google see in the page summary. The summary is also the first sentence of the story, so it should make sense when read continuously with the rest of the page. End with a full stop.

Body copy

Do not repeat the summary. Aim to tell the story in 1 or 2 sentences, for example who, what, where, when, why. Do not include more than 3 consecutive sentences of quotes.

Break up long news stories with subheadings. But remember that subheadings add to the text, they鈥檙e not part of it: the text should still make sense with the subheadings removed.

How to write effective body copy:

  • the first paragraph should lead on from the summary paragraph, not repeat the information
  • use the 鈥榠nverted pyramid鈥 approach with the most important information at the top tapering down to lesser detail
  • paragraphs should have no more than 5 sentences each
  • ensure copy includes keywords to boost natural search rankings
  • use video and images

Lead image

All news articles have a lead image. The lead image is shown at the top left-hand side of the published news article.

The first image you upload is used as the lead image. If you do not upload an image, the default image for your organisation will be used. You can change the default image on your organisation page. If your document also has an image in the body text, you must upload the lead image first.

News article: press release

Use for:

  • unedited press releases as sent to the media
  • official statements by an organisation spokesperson or minister (unless it鈥檚 a Parliamentary statement 鈥 in which case use the speech: statement to Parliament format)

Do not create a press release:

  • for statements to Parliament (use the speech format for those)
  • to promote the publication of other content (for example statistics)

Creating a new press release

Find out how to create and update a press release in Whitehall publisher.

Example

View a good example of a press release.

Writing and formatting requirements for press releases

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are some additional considerations you need to think about when writing a press release.

Title

Summarise the main point of the story.

Avoid starting titles with 鈥楽tatement on 鈥︹ or something similar: it just takes up space without communicating anything useful to the user, and makes it more difficult to tell one press release from another.

Do not put 鈥榩ress release鈥 or the name of the person making the statement in the title: this information will appear on the page automatically.

A good example: Mums and dads to share parental leave

Summary

Summarise the main point of the story (in slightly longer form than in the title).

The summary also acts as the first sentence of the story, so it should make sense when read continuously with the rest of the page.

Good example: New arrangements for maternity leave and paternity leave mean that parents will be able to choose how they share care responsibilities.

Body copy

Do not repeat the summary

Break up long press releases with subheadings. But remember that subheadings are an addition to the text, not part of it. The text should still make sense with the subheadings removed.

If you need to add notes at the end, use the subheading 鈥楤ackground鈥, not 鈥楴otes to editors鈥 or similar.

Lead image

All news articles have a lead image. The lead image is shown at the top left-hand side of the published news article.

The first image you upload is used as the lead image. If you do not upload an image, the default image for your organisation will be used. You can change the default image on your organisation page. If your document also has an image in the body text, you must upload the lead image first.

Organisation page

Use to:

  • give an overview of your organisation鈥檚 work, responsibilities and priorities

Creating a new organisation page

Find out how to create and update an organisation page in Whitehall publisher.

Writing and formatting requirements for organisation pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines.

Organisation pages also use specific headings and a set structure.

About us

Lead with 鈥榃e鈥 - it will be very obvious who the 鈥榳e鈥 is on this page.

Aim for no more than 30 words and give a broad overview of your department鈥檚 work. You may want to highlight areas that users might not assume are within your remit.

The 鈥榳hat we do鈥 section of your organisation page is automatically pulled from the content in the 鈥榮ummary鈥 field of your About us page. Writing 鈥榳hat we do鈥 information again will give you 2 鈥榳hat we do鈥 sections.

Responsibilities

Lead with 鈥榃e are responsible for鈥 and then a short, bulleted list of your responsibilities. Keep them active, clear and not too detailed - you can cover more detail in the content on your policies.

Use a maximum of 7 bullets.

Priorities

Lead with: 鈥楩rom 2023 to 2024, our priorities will be鈥︹ Make sure you keep this information, and the years referred to, up to date.

It鈥檚 best if you take your main priorities from your business plan - these are normally specific, clear and succinct.

Use a maximum of 7 bullets.

Who we are

Include a few lines about the number of staff you employ and where they鈥檙e based.

Corporate information

The corporate information section of your About us page will automatically display all your published corporate information pages. This will include for example your:

  • governance page
  • complaints procedure
  • accessible documents policy
  • energy use

Make sure it also includes your organisation chart (see for example the ). You can do this by adding a link to the relevant data.gov.uk page in the 鈥極rganisation chart url鈥 field on your 鈥榚dit organisation鈥 page.

These are the links at the top right of your organisation page. They鈥檙e to help users who鈥檝e arrived at your page looking for a service that鈥檚 closely associated with your organisation, but is actually covered on the services and information part of 伊人直播.

These links are optional: only keep them if there鈥檚 evidence that users are clicking on them. As a guide, each top task link should be followed by no fewer than 2% of total visitors to your homepage (measured in total unique pageviews).

Links should point either to 伊人直播 services and information (鈥榤ainstream鈥) content, or information or tools on domains outside 伊人直播. The text of the link must be as specific and active as possible, and not overlap with titles used for 鈥榗orporate鈥 content types.

Do not include anything that鈥檚 already covered by a link on the organisation page (such as contact details, lists of announcements or publications, blogs or social media channels).

Do not include campaign sites unless there鈥檚 evidence of significant user demand.

Feature slots

Do not feel that you have to use all the feature slots: the fewer content items you feature, the more they stand out. Remember that anything you feature needs to have an image.

Our ministers and management

Ministers tagged to your organisation will automatically appear on your organisation page, and should always have an up-to-date photo and biography.

Your organisation page should also include photos of all management members featured on your page.

Read more about adding a photo to people pages and what should be included in biographies.

Contact details

Include a point of contact for general enquiries and a point of contact for freedom of information (FOI) requests. Additional contact details are optional.

Example

View a good example of an Organisation page.

People and roles

Use to create profiles for:

  • ministers (always check with GDS before creating ministers)
  • the organisation鈥檚 most senior official (for example the permanent secretary or chief executive)
  • the organisation鈥檚 top tier of management (usually directors general)
  • senior officials with a public leadership role (for example Chief Scientist, Chief Medical Officer, military chiefs, ambassadors, high commissioners)

Do not:

  • create people pages for anyone else

Creating people and roles

Find out how to create and update people and roles in Whitehall publisher.

Examples

View good examples of a:

Writing and formatting requirements for people and roles

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

People and roles also use specific headings and a set structure.

Biography

Keep it short. One or 2 short paragraphs (one or 2 sentences each) or a single lead sentence with 5 bullets or fewer will do. If it鈥檚 a long career, just provide the highlights.

The first paragraph should cover:

  • the person鈥檚 full name (without title and letters, as it will appear directly above the text)
  • their current job title, and when they were appointed

In the second paragraph, provide a little information about the person鈥檚 background. You can either:

  • list up to 5 previous roles as bullet points, with the most recent at the top (if it鈥檚 long career, just provide the highlights)
  • say something more general about the types of role they鈥檝e had in the past

At first mention use the full name. After that, use the first name. So 鈥楶hilip Rutnam鈥 at first mention, then 鈥楶hilip鈥 after that.

Do not include information about their personal life, for example marital status, children, hobbies etc.

Do not use headings or subheadings.

Management biographies

Use a maximum of 3 sentences to explain what the manager is doing and 5 bullets on career highlights.

Ministerial biographies

Remember to:

  • keep it short: half a page is plenty for a biography
  • lead with: 鈥榌name] was appointed [title] in [date]. [He/she] was elected [name of party] MP for [constituency] on [date of election when the minister first became an MP]
  • first name terms: The Rt Hon Michael Gove MP at the top of the page, then use Michael Gove at first mention, then Michael
  • a Lord or Baroness will always use their title and surname, for example Baroness Warsi
  • education: avoid 鈥榬ead鈥, use 鈥榮tudied鈥
  • political career: a few sentences of career highlights in chronological order, if this is long, use bullet points, with an introductory sentence
  • career outside politics: if none, use 鈥榩olitical career鈥
  • personal life: do not include children鈥檚 names; delete this section if you do not need it

Note: when talking about ministers who have previously held a role, use their first name and surname.

Writing copy to describe a role

Get confirmation from the Cabinet Office/Number 10 digital team before making any change to a ministerial role title.

Give a brief description of the role: no more than 5 bullet points.

Do not use headings or subheadings.

Be specific when listing responsibilities. For example, do not use:

The minister is responsible for:

  • drugs
  • alcohol

Instead, use:

The minister is responsible for:

  • reducing drug misuse
  • reducing harmful drinking

Publications

Use for:

  • publishing standalone government documents - they are date-stamped and usually not updated once published
  • white papers, strategy documents and reports

Do not create a publication:

  • when you should be adding an attachment to another content format; for example meeting minutes and agendas
  • for meeting minutes (these should be attached directly to the relevant policy advisory group or governance page)
  • for videos (these should be embedded directly in the content they relate to 鈥 usually a news story or press release)

Creating a new publication

Find out how to create and update a publication in Whitehall publisher.

Writing and formatting requirements for publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are some additional considerations you need to think about when writing a publication.

Publication pages should be short and straightforward. Their purpose is to help the user find the publication that matches their needs as quickly as possible.

Users need to know whether they should open the document and if the information within meets their needs.

Think about:

  • search and SEO (ie include relevant keywords and phrases that users are searching for)
  • providing clear, concise information about what a publication is (so users can tell at a glance whether it will tell them what they need to know)
  • context (government often publishes lots of documents which look superficially similar 鈥 how will you help the user to find the right one?)

Do not:

  • summarise what the document says (you鈥檙e just repeating what鈥檚 in the document)
  • include general information about the topic covered by the publication (this is not the place for it)

Publication types

Look at the purpose of the document rather than the format. For example 鈥 classifying a publication as 鈥榞uidance鈥 is generally more helpful to users than telling them that the guidance happens to be in the form of a letter.

HTML

You should publish in HTML wherever possible. HTML is the most accessible format on mobile devices and for assistive technology because:

  • text automatically fits the page width as a user zooms in (it 鈥榬eflows鈥)
  • markdown ensures that elements are tagged correctly for screen readers
  • users can change the colours they use on 伊人直播

If your document is designed to be read but not edited or interacted with (read only), publish in HTML.

As well as static content you can use HTML for living, evolving documents that get updated. It is much easier to maintain one version of a publication in HTML than multiple versions in different formats.

Your HTML publication will have a publication date and you can give it a reference number or ISBN number.

Example of good HTML

View a good example of an HTML publication.

Other formats

If you cannot publish in HTML, you must publish your documents in open formats.

You must provide an email address in the details for users to request an alternative version of a document. You can do this by leaving the 鈥楢ttachment is accessible鈥 box unticked for all documents you upload. Even if you publish accessible versions, some users will need formats like British Sign Language (BSL), audio or braille.

If you publish a PDF or other non-HTML format, you are legally required to also publish an accessible version of your document.

Forms and editable documents

If users need to provide information or edit an attachment, for example complete a form, you should:

  1. create the document in Word, Excel or PowerPoint
  2. convert to an OpenDocument
  3. publish your OpenDocument

Alongside your OpenDocument, publish the form in at least one other format. Whichever other format you choose, you must make it as accessible as possible.

PDFs

You must not publish PDFs on 伊人直播 in most circumstances. There are some instances when you can publish a PDF. If these circumstances mean you do publish a PDF, you must publish an accessible version with it.

PDFs are not as accessible as HTML or OpenDocuments. For example, they do not allow users to change the colour of the background to meet their needs.

They are also more difficult to magnify because users will have to scroll horizontally and vertically. Text does not reflow to the width of the screen as it gets bigger like in HTML.

If you need to publish a PDF, you must format it to meet both the:

Titles

Titles do not have to reflect the official publication title. Keep them short and search- and user-friendly.

Front-load all titles 鈥 get all the most important words at the front of the sentence.

Good example: 鈥業ncome Tax reform: impact assessment鈥

Bad example: 鈥楢n assessment of the impact of proposed reforms to Income Tax鈥

You can mention the report title etc in the summary or page copy if you think users will search for that term.

Good example: 鈥業mproving government online services鈥

Bad example: 鈥楾he Varney report鈥

For transparency titles:

鈥楧fT special advisers: gifts and hospitality received, 13 May to 31 July 2020鈥

Note: use acronyms, colons and truncated dates.

Summary

Give a short summary (up to 160 characters) and end with a full stop.

Body copy

The body of a publication page provides a description of the publication in plain, neutral language, to reassure the user that it is (or is not) what they鈥檙e looking for. Include what the publication is about and its purpose. Publications often outlive governments so keep the language politically neutral.

Include links to related publications but use collections to group them if more than a few.

Good example: 鈥楾hese reports describe the effect of government proposals to reduce the amount of money spent on legal aid. The aim of the reforms is to make sure legal aid is still available for support and representation in cases where it is justified.鈥

Attachments

Use the official title of the document.

You should only add multiple attachments to a publication page if the attachments are:

  • forms and it鈥檚 a guidance page
  • chapters of one document
  • versions of the same document, for example an interim report and a final report

Use the translations feature if you need to add a different language version of the same document.

It鈥檚 fine to have multiple attachments on a consultation page.

Publication: corporate report

Use these for publications that are about what the organisation is as a corporate entity (for example annual reports, business plans, accounts, structural reform plans, performance and efficiency reviews).

Do not use them for publications that are about what the organisation does (such as a strategy document showing how the organisation plans to meet its policy objectives would probably be a policy paper).

Creating a new corporate report publication

Find out how to create and update publications in Whitehall Publisher.

Example

View a good example of a corporate report.

Writing and formatting requirements for corporate reports

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including corporate reports, must also follow the publications guidance.

Publication: correspondence

Use for:

  • ministerial or departmental responses (for example to campaign letters), announcements or statements
  • regularly issued circulars or bulletins (for example fire service circulars), official correspondence to professionals (for example, 鈥淒ear chief planning officer鈥 letters)
  • letters to individuals or organisations that are published in order to share with a wider audience
  • online versions of e-bulletins or newsletters

Do not use for:

  • minutes, agendas or other meeting papers (attach them to relevant policy detail, organisation or our governance pages instead)
  • formal decision letters from tribunals, regulators or adjudicators - use the decision format

Creating a new correspondence publication

Find out how to create and update correspondence publications in Whitehall publisher.

Example

View a good example of a correspondence letter.

Writing and formatting requirements for correspondence publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including correspondence, should also follow the publications guidance.

Publication: decision

Use for:

  • formal decisions made by tribunals, regulators or adjudicators (including courts and the Secretary of State) that need to be published for legal reasons or because they relate to locally or nationally significant issues

Decisions outlined in letters or other correspondence should use this format - do not use the 鈥榗orrespondence鈥 format.

Do not use for:

Creating a new decision publication

Find out how to create and update decisions in Whitehall publisher.

Writing and formatting decisions

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including decisions, should also follow the publications guidance.

Publication: form

Use for:

  • forms or pro forma documents that need to be completed by the user (either online or in hard copy)

The page can include guidance on how to fill in forms, so there is no need to create a separate guidance publication for form instructions.

Creating a new form publication

Find out how to create and update publications in Whitehall Publisher.

Example

View a good example of a form.

Writing and formatting requirements for form publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including forms, should also follow the publications guidance.

To help you simplify your forms and make them as accessible as possible, find out how to create a simple open document form.

Publication: Freedom of Information (FOI) release

Use for:

  • responses to FOI requests

Make sure the title describes specifically what the request is about.

Creating a new FOI release

Find out how to create and update a Freedom of Information release in Whitehall Publisher.

Example

View a good example of an FOI release.

Writing and formatting requirements for FOI publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including Freedom of Information releases, should also follow the publications guidance.

Publication: guidance

Use for:

  • non-statutory guidance publications like manuals, handbooks and other documents that offer advice
  • guidance material that has been produced as a standalone hard-copy publication rather than web-original content

Do not use for:

  • statutory guidance (use the statutory guidance publication type) or guidance about completing a form (attach to the same publication as the form itself)

Creating a new guidance publication

Find out how to create and update a guidance publication in Whitehall Publisher.

Example

View a good example of a guidance publication.

Writing and formatting requirements for guidance publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including guidance, should also follow the publications guidance.

Publication: impact assessment

Use for:

  • documents that assess the impact of new initiatives or changes to legislation (for example impact assessments, equality impact assessments and equality impact analyses)

Do not:

  • create a new page for them, if possible add them as a supporting document to the 鈥榩arent鈥 publication, where there is one

Creating a new impact assessment publication

Find out how to create and update a publication in Whitehall Publisher.

Example

View a good example of an impact assessment.

Writing and formatting requirements for impact assessments

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including impact assessments, should also follow the publications guidance.

Publication: independent report

Use for:

  • reports commissioned by government but written by non-government organisations, including independent enquiries, investigations and reviews

Creating a new independent report publication

Find out how to create and update an independent report in Whitehall Publisher.

Example

View a good example of an independent report.

Writing and formatting requirements for publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including independent reports, should also follow the publications guidance.

Publication: map

Use for:

  • drawn maps
  • geographical data

Creating a new map publication

Find out how to create and update a publication in Whitehall Publisher.

Writing and formatting requirements for map publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including maps, should also follow the publications guidance.

Publication: notice

Use for:

  • permit and licence applications that have to be published temporarily in a public space so people can view, comment or lodge an objection

Do not use for:

Creating a new notice

Find out how to create and update notices in Whitehall publisher.

Example

View a good example of a notice.

Writing and formatting requirements for notices

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including notices, should also follow the publications guidance.

Publication: official documents

Official documents are types of papers that are laid before (presented to) Parliament. These include:

  • command papers
  • House of Commons papers
  • unnumbered act papers

Official documents should be published as attachments to the publication type you鈥檙e using, for example a policy paper. Publish them as HTML publications alongside the PDF versions.

Creating a new official document

Find out how to create official documents in Whitehall Publisher.

Writing and formatting requirements聽

The HTML and PDF versions of all official documents must contain the:聽

  • title
  • copyright owner (HTML versions are Crown copyright unless you state otherwise, for example: 鈥樎 Financial Conduct Authority鈥)
  • ISBN reference

Command papers must also have:

  • a statement to explain how the paper was presented to Parliament, such as: 鈥楶resented to Parliament by the Secretary of State for Transport by Command of His Majesty鈥
  • the month and year the paper was laid before Parliament
  • the Command Paper number (CP)

House of Commons papers must also have:

  • a statement to explain how the paper was presented to the House of Commons, such as: 鈥楶resented to the House of Commons pursuant to section 7 of the Government Resources and Accounts Act 2000鈥
  • the date is was ordered to be printed, such as: 鈥極rdered by the House of Commons to be printed on 12 October 2018鈥
  • the House of Commons number (HC XXXX)

Unnumbered act papers must also have a statement to explain how the paper was presented to Parliament, such as: 鈥楶resented to Parliament pursuant to section 7 of the Government Resources and Accounts Act 2000鈥.

Publication: policy paper

A policy paper explains the government鈥檚 position on something. It does not include instructions on how to carry out a task, only the policy itself and how it鈥檒l be implemented.

Publications about government policy include:

Audiences

When writing a policy paper, remember they are aimed at:

  • high-level specialists (such as head teachers or someone who runs a service)
  • people who hold government to account

If the content contains guidance for a user to act on, this should be in the guidance format.

Policy documents are usually tagged to a particular government, for example the 2005 to 2010 Labour government.

Creating a new policy paper

Find out how to create and update a policy paper in Whitehall Publisher.

Example

View a good example of a policy paper.

Writing and formatting requirements for policy papers

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including policy papers, should also follow the publications guidance.

Publication: promotional material

Use for:

  • leaflets, posters, fact sheets and marketing collateral

Creating a new promotional material page

Find out how to create and update a promotional material page in Whitehall Publisher.

Example

View a good example of promotional material.

Writing and formatting requirements for promotional material pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including promotional material, should also follow the publications guidance.

Publication: regulations

Use for:

  • regulations imposed by an independent regulatory authority (for example Military Aviation Authority, Medicines and Healthcare products Regulatory Agency, Ofsted)

Do not use for:

  • statutory guidance describing requirements that are mandatory by law - use the statutory guidance format
  • non-statutory guidance like manuals, handbooks and other documents that offer advice

Creating a new regulations publication

Find out how to create and update regulations in Whitehall Publisher.

Example

View a good example of a regulation.

Writing and formatting regulations

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including regulations, should also follow the publications guidance.

Publication: research and analysis

Use for:

  • research reports
  • surveys
  • analyses
  • evaluations

They can be conducted by government, commissioned by government or independent of government.

Creating a new research and analysis page

Find out how to create and update a research and analysis page in Whitehall publisher.

Example

View a good example of a research and analysis page.

Writing and formatting requirements for research and analysis pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including research and analysis, should also follow the publications guidance.

Publication: statistics

Use a statistics publication for data sets that:

  • you publish infrequently, such as less than once a month
  • you鈥檙e publishing with accompanying analysis

For raw data sets that you publish monthly or more often, use a statistical data set instead.

Types of statistics publications

There are two types of statistics publication.

鈥楢ccredited official statistics鈥 publications are for official statistics that have been awarded the by the Office for Statistics Regulation (OSR).

鈥極fficial statistics鈥 publications are for:

  • official statistics that do not have the accredited official statistics badge
  • experimental statistics - make sure this is written in the title or summary

Creating a new statistics publication

Find out how to create and update a statistics publication in Whitehall Publisher.

Examples

View a good example of an:

Writing and formatting requirements for statistics publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Where possible, files should be attached as .csv files or an open format (eg .ods, .odt). Avoid proprietary formats (for example Excel or Word).

Publication: statutory guidance

Use for:

  • guidance that relevant users are legally obliged to follow

Do not use for:

  • non-statutory guidance, use the guidance publication type

Creating a new statutory guidance page

Find out how to create and update a statutory guidance page in Whitehall publisher.

Example

View a good example of a statutory guidance publication.

Writing and formatting requirements for statutory guidance pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

All publications, including statutory guidance, should also follow the publications guidance.

Publication: transparency data

Use for:

  • data that organisations are routinely required to make available to the public

Do not use for:

  • FOI enquiries
  • information that is not going to be published on a regular and ongoing basis

Creating a new transparency publication

Find out how to create and update transparency publications in Whitehall publisher.

Example

View a good example of transparency data.

Writing and formatting requirements for transparency publications

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Where possible, attachments should be saved as .csv files or an open format (for example .ods, .odt). Proprietary formats (for example Excel, Word) should be avoided.

If you are publishing Corporate Commitments, you must use the Whitehall Corporate Commitments transparency template.

Do cut and paste the text from the template to fill in the following fields:

  • publication titles
  • publication summaries
  • publication detail
  • document (attachment) titles

Do not:

  • change or edit the text in any way - it has been agreed with Cabinet Office Transparency Team
  • create your own departmental collections, add your publications to the relevant collection listed on the template

If you have questions about reporting obligations, contact your departmental transparency team or the Cabinet Office Transparency Team.

If your question is about ministers, special advisers or senior officials, contact the Cabinet Office Propriety and Ethics Team.

The Corporate Commitments include:

  • ministerial gifts, hospitality, travel and meetings
  • special advisers鈥 gifts, hospitality and meetings
  • senior officials鈥 business expenses, hospitality and meetings
  • government procurement card spending
  • departmental spending over 拢25,000
  • departmental exceptions to spending controls
  • departmental roles and salaries
  • departmental workforce management information

The Corporate Commitments template can be used as the basis for other transparency publications.

Specialist finder

Specialist finders help users find and navigate large collections of documents.听

They鈥檙e aimed at specialist or professional audiences who need to find documents among a large collection by filtering for specific criteria.

They鈥檙e published using Specialist Publisher. This is a separate tool to Whitehall Publisher.

Use specialist finders for document collections that:

  • contain over 100 documents聽
  • have new documents added regularly
  • require complex searches on multiple filters, such as 鈥楻egion鈥 or 鈥楥ategory鈥

Do not use them for:

  • complex content with numbered or named chapters or clauses 鈥 these are more suited to manuals
  • grouping pages that contain different types of content 鈥 these are more suited to topic pages
  • collections that will have fewer than 100 documents and will not be used or updated regularly - these are more suited to document collections

Creating a new specialist finder

You must contact GDS for permission to create a specialist finder.

Find out how to request a new specialist finder.

If a specialist finder is agreed, developers at GDS will create it. This can take up to 6 months. You鈥檒l then be given access to Specialist Publisher so you can start adding documents.

Example

See a good example of a specialist finder.

Writing and formatting requirements for specialist finders

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Specialist finders are used to complete a specific task, which is usually to 鈥渇ind鈥 a document related to a specialist interest. Name the specialist finder with an appropriate verb, like 鈥楩ind funding for land or farms鈥.

Specialist finders also have a range of filters you can give to users. These can include different topics, like 鈥楻egion鈥 and 鈥楥ompany鈥, and different selection options, like multiple choice and date ranges. Do user research to find out which filters users will need.

Speech

You can publish different types of speech on 伊人直播, including:

  • transcript (for verbatim reports of exactly what the speaker said 鈥 also known as 鈥榗hecked against delivery鈥)
  • draft text (for reports of what the speaker was supposed to say 鈥 also known as 鈥榗heck against delivery鈥)
  • speaking notes (if it鈥檚 not a complete speech 鈥 for example it鈥檚 a summary of topics covered)
  • written statement to Parliament
  • oral statement to Parliament
  • authored article

Use for:

  • public speeches by ministers or other named spokespeople, ministerial statements to Parliament and bylined articles

Do not create a speech:

  • unless you expect a high level of public interest in everything that what was said, not just the main messages (otherwise, it鈥檚 better to publish a press release or government response quoting selected highlights, along with some commentary and analysis)
  • just to publish a statement to Parliament as a matter of record (that鈥檚 what Hansard is for)
  • unless it鈥檚 necessary context for understanding how a policy is progressing
  • for statements made to the media (use press release or government response)

Creating a new speech

Find out how to create and update a speech in Whitehall publisher.

Examples

See good examples of:

Writing and formatting requirements for speeches

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

There are some additional considerations you need to think about when publishing a speech.

Title

Summarise the main point of the speech in the title. Go for something like the titles used for newspaper comment pieces.

Do not include the word 鈥榮peech鈥 in the title (it鈥檚 added to the page automatically).

Also do not use the words 鈥榮tatement鈥 or Parliament鈥 in the title (the words 鈥極ral statement to Parliament鈥 or 鈥榃ritten statement to Parliament鈥 will appear on the page automatically).

Do not include anything about the speaker, date, venue or audience in the title (the date and speaker appear on the page automatically: if it鈥檚 needed, put information about the venue or audience in the summary).

Good example: National security and civil liberties: getting the balance right.

Summary

Give details of the occasion for the speech (including any terms that people are likely to be searching for).

There鈥檚 no need to specify whether it鈥檚 a written or oral statement in the summary (this information appears on the page anyway), and no need to say that the statement was given to Parliament (that鈥檚 self-evident).

Good example: Statement on Action Fraud reports not processed correctly due to a fault in the IT system.

Statistical data set

Use a statistical data set for data that you publish monthly or more often without analysis (ie raw data).

For data sets that you publish less frequently or with analysis, use a statistics publication.

Create a statistical data set

Find out how to create a new statistical data set document in Whitehall publisher.

Writing and formatting requirements for statistical data sets

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Where possible, data sets should be attached as .csv files or an open format (for example .ods, .odt). Avoid proprietary formats (for example Excel or Word).

Statistics announcements

You must announce your statistics using the statistics release calendar to comply with the .

Use for:

  • announcing when national and official statistics will be released
  • explaining any changes to confirmed release dates
  • announcing changes to the way statistics are collected and classified

Do not use for:

  • announcing supporting documents (such as quality reports or methodology)
  • announcing the release of statistical datasets

National and official statistics must be announced 12 months before the release date. If you do not know about the statistics 12 months in advance, announce them as soon as possible.

Give a 1 or 2 month period when the statistics will be released. You must give an exact date at least 4 weeks before your statistics are due to be released, or 6 months if it鈥檚 market sensitive.

Creating a new statistics announcement

Find out how to create and update a statistics announcement in Whitehall publisher.

Writing and formatting requirements for statistics announcements

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title and summary.

Topical event pages

Topical event pages are used to communicate government activity about high-profile events or in response to a major crisis. You must get approval from GDS before creating one.

Use for an event or crisis that is:

  • high profile
  • current or relevant only for a short time (for example Ebola virus: UK government response)
  • of significance to the majority of 伊人直播鈥檚 users (ie the event is receiving extensive coverage by major news media such as the Today programme)
  • the responsibility of central government
  • linked to more than one government department or agency
  • likely to generate a high volume of content (not just one or two news stories)

Do not use for:

  • issues on which the government position can be covered by a topic or policy paper, and/or document collections (for example changes to the healthcare system)
  • issuing emergency guidance - consider how to reach your intended audience quickly, for example social media, press releases etc
  • events which can be reasonably covered by a lead news story on a departmental homepage (although news stories may develop into topical event pages following additional content generation or increased public interest)
  • influencing behaviour change - this is the role of campaign sites

Creating a new topical events page

Find out how to create and update topical event pages in Whitehall Publisher.

Writing and formatting topical event pages

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body text.

There are also some additional considerations you need to think about when creating a topical event page.

Name

Use the name of the event and the year (for example D5 London 2014) and state if it鈥檚 a government response to a crisis or event (for example Ebola virus: UK government response).

Description

Keep the description short and use it to briefly explain:

  • what the event is
  • the government鈥檚 involvement
  • what the page is about

About

Use the 鈥榓bout鈥 page to give more detailed information on what the government is doing about the event. The title of the topical event page will appear automatically at the top of the 鈥榓bout鈥 page, so do not duplicate this.

Feature slots

You can feature up to 6 documents that are tagged to the topical event page. You鈥檒l need to have an image for each of these.

World news story

Use for:

  • announcements specific to one or more world location

Do not duplicate news published by another department.

Creating a new world news story

Find out how to create and update a world news story in Whitehall publisher.

Writing and formatting requirements for world news story

All content should follow the GDS style guide and Writing for 伊人直播 guidelines. Read these to find out how to write your title, summary and body copy.

Worldwide priority

This content type is no longer available.