Standard content types

Case studies

When to use this content type

Use case studies for real examples that help users understand someone’s personal experience with either:

• a task that’s covered on GOV.UK (for example, it shows someone’s experience of taking part in a particular government programme)
• an important aspect of government policy that’s covered on GOV.UK (for example, it shows someone’s experience of a policy problem the government is trying to solve)

They can be either a first person account or a third person account with quotes from the person it’s about. They can be in video form.

See a good example of a case study on GOV.UK.

Do not create a case study if:

• it’s just about promoting your organisation – this makes it harder for users to find the practical information they need
• it does not relate directly to guidance or policy content on GOV.UK, or add something really important to it
• it’s only going to be useful for a short time – if so, it will be better dealt with in a news article
• it’s similar to an existing case study – this can confuse users

Remember, most users just want practical guidance. Case studies can make it harder to find that guidance, as they can take up space in search results and give users something else to read. It’s often best to concentrate on getting the wording of the guidance right instead.

Create a draft

To create or update this content type, you’ll need a Signon account with access to Whitehall Publisher.

If you’re creating a new case study

1. Go to Whitehall Publisher.
2. Select the ‘New document’ tab.
3. Select ‘Case study’ and then select the ‘Next’ button.
4. Add the title. It should summarise the point of the case study, like ‘UK money helps to build homes in Darfur’.
5. Add the summary. It should outline what happened, why it happened and the result.
6. Add the body. Include information about how the case study supports a particular policy (with links to relevant pages). If you can, include statistics and facts about things like how many people will be helped and how much money is being spent. Finally, include the human element of who is benefiting and how. Avoid too much detail about the past or too many quotations (unless it’s an interview).
7. Select ‘Limit access’ under ‘Settings’ if your draft is sensitive. This means only users from organisations tagged to the content can see it before it’s published. It will not be copied across to Integration.
8. Select the ‘Save’ button at the bottom of the page.

Read the tone of voice guidance and formatting guidance for help with writing the title, summary and body.

After saving the page, you can add images and attachments.

If you’re updating an existing case study

1. Go to Whitehall Publisher.
2. Select the ‘Documents’ tab.
3. Search for the case study you want to edit, and select the ‘View’ link next to it. This will take you to the edition summary page. If you only want to update the topic tags and nothing else, select ‘Change tags’ under ‘Topic taxonomy tags’. Otherwise, keep following these steps.
4. Select the ‘Create new edition’ button. If a new edition has already been created, select the ‘Go to draft’ link. You can then select ‘Edit draft’ or, if you do not want to use this draft, select ‘Delete draft’ and then select ‘Create new edition’.
5. Make any changes to the title, summary or body as needed. Read the tone of voice guidance and formatting guidance for help.
6. Do not change anything under the ‘Political’ heading. This is related to history mode and it will only need to be changed if your organisation is asked to take part in an audit of content before a general election.
7. Select ‘Limit access’ under ‘Settings’ if your draft is sensitive. This means only users from organisations tagged to the content can see it before it’s published. It will not be copied across to Integration.
8. Decide whether you need to write public change notes. Go to the bottom of the page and select the relevant option under ‘Do users have to know the content has changed?’, and add your change notes if needed (you can edit them again before you publish the draft).
9. Select the ‘Save’ button at the bottom of the page.

If you select ‘Create new edition’ and you get a message telling you that the ‘document is in history mode’, you cannot update it without help from the Government Digital Service (GDS). See the guidance on removing history mode for more details.

You can now edit the images and attachments.

Add or remove images

Make sure you’ve correctly formatted the images before you add them.

Select the ‘Images’ tab at the top of the page. You can upload images here. Each image will need a different file name.

Once you upload an image, you’ll be given a ‘Markdown code’. You can copy and paste that into the body and the image will appear there.

If you want to remove an image, you can remove its code from the body. You can then upload a new version of the image and use its code instead.

Select a lead image

The lead image appears above the body content, and cannot be used again in the body.

Your organisation’s default lead image will be used unless either:

• you upload another image and make that the lead image
• you remove the lead image from the content

If you upload another image, use the ‘Select as lead image’ button to make it the new lead image. You cannot do this with a SVG file.

If you want to remove the lead image completely, select ‘Remove lead image’.

You can also update your organisation’s default lead image. Read the guidance on updating organisation pages for instructions.

Add or edit attachments

Make sure you correctly format attachments before you upload them.

Select the ‘Attachments’ tab at the top of the page. You can add, edit or delete attachments from here.

You can quickly overwrite previous versions of attachments if you upload new files with the same file names as your old ones.

You cannot add HTML attachments to this content type.

If you’re adding new attachments

When you add attachments:

• use the official title of the document
• do not tick ‘Attachment is accessible’ – this means users can ask for the attachment in an accessible format like audio or Braille

For each attachment, you get 2 codes that you can add to the body. You can either add the attachment as:

• an ‘inline’ link – this means you can add a download link to the middle of a sentence or in a bullet point list
• a ‘publication box’ – this means you will have a separate section with a download link, alongside information about how to request the attachment in an accessible format

Read the formatting guidance for more information about the different types of attachment code and when they should be used.

Add or remove contact details

You can add contact details using your organisation’s contact directory. That means if the details in the directory are updated, they’ll automatically update in your content too.

Your organisation’s most used contact details should be in the contact directory. Find out how to create or update contacts.

To add a contact from a directory:

1. Go to ‘More’ at the top of Whitehall Publisher.
2. Select ‘Organisations’ and find the organisation that owns the contact. Select ‘View’ next to their name.
3. Go to the ‘Contacts’ tab and copy the relevant ‘Markdown code’.
4. Paste the code into your document.

You can remove the contact details by deleting the code.

If you do not want to use the contact directory, use the formatting guidance to add contact details.

Change the ‘first published date’

You can change the first published date if the same content was available on another webpage before, like on another GOV.UK page you’re unpublishing or a campaign site you’re closing.

Under ‘First published date’, tick the ‘This document has previously been published on another website’ box. Select the new date.

The new date will show when you publish the draft.

Add or remove tags to organisations

You can tag your content under the ‘Associations’ heading. You do this by adding or removing associations.

These associations include:

• world organisations and locations – use this if you work for the Foreign, Commonwealth and Development Office (FCDO) and you want the case study to appear on a worldwide organisation page or a world location news page

• lead and supporting organisations – your own organisation will be set as a lead organisation as default, but you can change that or add any other organisations if they’re responsible for the content

Update settings of the draft

Under the ‘Settings’ heading, you can:

• change the ‘Email address for ordering attachment files in an accessible format’
• select ‘Schedule publication’, if you want the draft published at a certain time and date
• select ‘Review date’, if you want to get an email asking you to check the content at a later date after you’ve published it

Add or remove topic tags

You need to tag your draft to at least one topic page before you can publish it.

Your content will appear on the tagged topic pages when:

• the draft is published, if it’s new content
• you save the new tagged topic pages, if you’re updating existing content

See the ‘Education, training and skills’ topic page for an example of what these topic pages look like.

To add tags:

1. Select ‘Save and go to document summary’ on your current draft.
2. Under the ‘Topic taxonomy tags’ heading, select ‘Add tags’ or ‘Change tags’.
3. Tick the boxes next to each topic that applies. The arrows next to each topic will expand the topic out, showing all sub-topics in that topic ‘tree’.
4. Select ‘Save’.

To remove tags, select ‘Remove topic’ next to the one you want to remove and then select ‘Save’.

Choose topic tags:

• based only on what the content is about
• from anywhere in the topic ‘tree’, not just the areas that your organisation uses the most

Try to choose the most specific topics you can.

You can tag your content to as many topic pages as are relevant. There’s no limit.

Add or edit translations

Add a new translation

Read the guidance about deciding whether to add a translation.

If you do want to add a translation:

1. Select ‘Save and go to document summary’ on your current draft.
2. Under the ‘Translations’ heading, select ‘Add translation’.
3. Add the translated title, summary and body.
4. Select ‘Save’.
5. If you want to add any translated attachments, go back to the English version and add the attachments there. You can then copy the code and paste it into the translated version.
6. Check the translations are working by selecting ‘Preview translated pages’ under the ‘Preview’ heading.

If you’re adding a translation for a language that is written from right to left, there’s a different way to format links.

Edit an existing translation

If you want to update the title, summary or body of a translation:

1. Select ‘Save and go to document summary’ on your current draft.
2. Under the ‘Translations’ heading, select ‘Edit’ next to the relevant translation.
3. Make the changes and select ‘Save’.

If you want to update an attachment:

1. Go to the ‘Attachments’ tab at the top of the draft of the English version.
2. Select ‘Edit attachment’ under the relevant attachment.

Update the URL

URLs are automatically created from the page title when you first publish the content. You might want to update the URL if there’s a spelling mistake or if it no longer reflects the content.

If the content has never been published before

You can update the draft title and the URL will change.

If the content has been published already

You can:

1. Create a new piece of content with the desired title and URL.
2. Copy over the current content to this new draft.
3. Publish the new draft.
4. Unpublish the page with the incorrect URL. When you unpublish it, you’ll be able to set up a redirect to the new page.

The change notes history will be lost if you do this. If you need to keep that history, contact the Government Digital Service (GDS) and ask them to change the URL instead.

Publish the draft

Find out how to send the draft for review.

If you need to publish it urgently without a review, find out when you can publish your own draft.