Creating and editing web content

This guide is for anyone creating  and editing web content for publication on a NIHR website.

When creating content, you need to write from the perspective of what your users want to know and how they will find your content. You also need to consider the information already on the website and how this will complement it.

It is important to get the point of your content across as concisely as possible.  Use the guidance below to help you.

Focus on user needs

Develop content based on user and organisation needs. 

Ideally, you should:

• consult with the people who are going to use your content

• design and test your content to make sure it meets their needs

• improve your content based on user feedback

• involve colleagues and other key stakeholders in developing the content and ensuring it is accurate

Make your content easy to use

Make sure your content and design are simple and clear. Use concise, plain English so your content is easy to understand.  Aim for readability grade 9-10 on the Hemmingway editor.

Follow the NIHR style guide for language, tone and formatting consistency.

Readability

• Formatting: have you used bullet points, lists, and short paragraphs to break up large blocks of text?

• Visuals: Add images, videos, or other multimedia to enhance engagement but ensure they are accessible

• Quotes and stats: Consider using these components. But be careful not to make them too long and ensure they don’t detract from the page

• Content cards: Use these to add links with images and to help break up lists of links

Structure

Think about the structure of your content and how you can help users find what they need quickly and easily. Some tips include:

• Compelling headline or title: does the headline or title accurately reflect the content and grab the reader's attention?  Is it shorter than 65 characters? Does it use the words your users would type into a search engine to find the content?

• Engaging opening: does the first paragraph summarise the key message and entice the reader to continue?

• Follow the inverted pyramid: is the most important information presented first, followed by supporting details? Find out more about Inverted Pyramid: Writing for Comprehension

• Clear call to action: does the content include a clear call to action or next step, if relevant? For example, should the reader ‘visit this page to learn more about the trial’,  ‘contact us to learn more’ or ‘sign up to our newsletter’

• Page URL: is the URL concise and relevant to the content?

• Cross-promotion: are there links to other relevant NIHR resources or webpages? What should the reader look at next?

Make your content accessible

Make your content accessible to everyone who needs it. Main things to consider:

• Write in plain English

• Ensure your page is optimised for search engines. Each page should have a unique primary keyword and approximately 5-10 secondary keywords.

• Use a logical heading structure to organise your content and aid navigation (heading 2 to introduce a topic or section, followed by heading 3 to introduce a sub-topic)

• Use descriptive link text that indicates the destination of a link, it's best to use the title of the page you are linking to as the link text

• Add alternative text for images if they are not decorative.  Graphics and diagrams which impart information should also provide a text alternative

• Add a transcript when you add a video from YouTube

Find out more about website accessibility

More information

You can access guidance on using the Drupal CMS once you have logged in to the website, under 'NIHR documentation'.

How Little Do Users Read?  Article by Jakob Nielsen

Writing for the Web Articles and Videos

UX writing: Study guide

Writing for gov.uk guidance