BETA This playbook is in BETA, we think it’s good enough to be useful right now, but there are gaps that need filling – your feedback will help us to improve it.

Part of
Creating accessible web content: Step by step

Click "navigate this page" to see the page contents, as well as a full list of the Creating accessible web content step by step pages.

Creating content sections on content pages

When writing for the web it is important to structure your content in sections with descriptive titles. To do this on content pages simply use a separate ‘Content block’ for each section and type your title into the ‘Title’ field.

You can add new content blocks by pressing the ‘Add row’ button in the bottom right of the block.

Each block that you make creates a ‘Page contents’ link on the left side column of the page. This allows the customer to easily jump to the section of the page that they are most interested in.

information

It is important to make sure there are no spaces after your title text, as this will break the page contents links.

It is also important never to use the same text for a content block title as a link within the text, this is because it creates a situation where two links on the page sound the same to a screen reader user, but go to different destinations.

Creating content sections on news articles

When you are creating a news article the page looks slightly different – there is no left column for page contents. In the admin view you do not have the option to create sections with content blocks, instead you need to use ‘Headings’.

We will go into detail about how to properly structure headings later in this guide. For now it is just important to know they can be selected using the ‘Paragraph’ dropdown on the left of the content block ribbon.

Why layout matters

For users who rely on assistive technology like screen readers, a web page without a logical reading order can be confusing or even unusable. Headings provide a meaningful structure for these accessibility tools, and the customer can choose to listen to the whole page, or just the headings in isolation to quickly navigate a page if they want to.

information

Listening to web content on a screen reader can be very time consuming if a web page or article is not structured correctly. Providing headings is a great way to create an enjoyable user experience for everyone, and to show our disabled customers that we care about their experience.

Last reviewed: November 4, 2025 by Jennifer

Next review due: May 4, 2026

Back to top