Skip to main content

How we made it easier for publishers to share previews of their work

Woman with laptop on her lap showing Cost of Living GOV.UK page in Whitehall publisher

There are more than 500,000 pages on GOV.UK. This means there’s a lot of content on the site, with thousands of items edited and published every week.

Most civil servants publish content on GOV.UK using a tool called Whitehall - a bespoke content management system. Publishers will only put something live once it has gone through various checks and reviews to make sure all content on GOV.UK is accurate and formatted correctly.

This review process often leads to people who aren’t publishers needing to see a draft of the content before publication. However, only people who regularly publish on GOV.UK have access to publishing tools like Whitehall. This could lead to frustrations when sharing drafts with workarounds including taking and sharing screenshots, which all took time and effort.

We’ve now improved the process so that publishers can share previews of their content quickly and easily with anyone who needs it. This improvement will make it easier for the thousands of civil servants who work on GOV.UK every single day to do their jobs.

The user need

Reviewing content before publishing it is a standard part of the content design process on GOV.UK. The people involved in reviewing content before it's published on GOV.UK could include:

  • a publisher who needs to review the content
  • a subject matter expert who has contributed to the content and needs to check the factual accuracy
  • a stakeholder who needs to know what’s changing so they can plan their work
  • a stakeholder who needs to test the page structure or content with users

We knew there was frustration that people couldn’t share a preview of their draft content with the people who needed to check or approve it. Our research indicated people were using some time consuming workarounds, such as installing extra software for screenshots.

For pages with lots of linked attachments, for example: COVID-19 Response: Autumn and Winter Plan 2021, this adds time and effort to the publishing journey and makes it harder for people without access to publishing tools to preview draft content.

This was a problem that affected a lot of civil servants working on GOV.UK. In the last 6 months, we’ve had more than 2,000 active publishers who have edited more than 100,000 pages in Whitehall. We estimate that more than 75% of that involves a review of the draft content on GOV.UK, probably multiple times by multiple people.

So we knew that improvements here would make a big difference.

What we did

Our approach is based upon the JSON Web Token web standard. We generate a random value in our publishing tool, the auth-bypass-id, and we use this to create a cryptographically-signed token which can be used as a query parameter for the URL. The use of cryptography prevents a user from being able to guess a document's auth-bypass-id.

When a publisher wants to share this draft content with someone, they can use the ‘shareable preview’ link. This is made up of the normal link to the content on our draft site, and a query parameter containing a ‘token’. This token contains some data (including the auth-bypass-id) securely encoded as a JSON web token.

This means that when a reviewer accesses the content via the shareable preview link, their token is decoded and the auth-bypass-id contained within it is compared to the auth-bypass-id stored on the edition. If it matches, great! The reviewer can see the draft content, as it would appear on the website, without needing to log in to anything. If it doesn’t match, they will not be able to see the draft, but will be asked to log into the publishing tools.

How it works now

With this solution, publishers can now save a draft edition, open the ‘share document preview’ panel and get a shareable document preview link.

This link can be shared with anyone who needs to preview the draft content as it will appear on GOV.UK. After the content is published on GOV.UK, the shareable document preview link will no longer work. If a publisher creates a new edition of their content, they can get a new shareable document preview link.

The shareable preview links are very secure. Publishers are told in the publishing tool when they copy a link that anybody with the link can view it and that they are responsible for who they share draft documents with.

If the link is shared with someone it should not be shared with or if they no longer want to share the preview of a draft, publishers will be able to generate a new shareable document preview link. This means the previous link will no longer be valid and they’ll need to reshare the link if needed.

The user interface for the shareable previews shows under the normal 'preview on website' button on a draft page. It has a ‘Share document preview’ section with a ‘Copy link’ button which allows the preview link to be shared with someone so they can see how the document will appear on GOV.UK. It shows the date the link will expire. It also has a ‘Generate new link’ button which allows you to reset and generate a new preview link, disabling the previous preview link.

The results so far

This solution was launched on 22 June 2022 and in the first 2 weeks, the shareable link option was used 1,202 times, with some links viewed as much as 25 times.

We’ve had feedback from publishers, who say:

Your team has introduced some great features over the past couple of weeks that have really made my working practices so much easier and more efficient. This might just be the icing on the cake and I'm using it loads already” - Content Designer, DCMS

As mentioned above, we have lots of people editing lots of content in Whitehall. Our improvements will save those people time and ultimately save the government money.

Get in touch

We are continuing to make improvements to the publishing experience. If you have any questions or feedback about this update or publishing, you can reach us by emailing

We’re also running regular research to learn more about how people use the publishing tools or test ideas for how things might change.

If you sign up, you could be invited to activities like showing the team how you complete a task, talking to us about your experiences of publishing on GOV.UK, or testing new designs. We usually only ask you for an hour of your time and you are more than welcome to say no.

To sign up and take part in user research, sign up through the Google form or by emailing

Subscribe to Inside GOV.UK to find out more about our work

Sharing and comments

Share this page


  1. Comment by Dale Moore posted on

    This sounds like a much needed improvement. I often had to use workarounds when I last used Whitehall Publisher when working with the ESFA.

    Great work. I’m sure it will make many people’s day jobs a whole lot easier!

  2. Comment by Dean posted on

    This is already saving me bags of time - probably hours for a single complex publication I've just been working on. Many thanks!

  3. Comment by Rebecca Fowler posted on

    This is a game-changer for GOV.UK publishers.

  4. Comment by Keith posted on

    Thanks Tobi

    This has made such a big difference to the way I work and manage relationships with stakeholders. In my opinion it's the most needed and useful improvement to Whitehall publisher for publishers in 10 years.

    Keep up the good work!