Understanding website structure, the skeleton of a webpage, is fundamental to building clean, navigable, and accessible webpages.

Even if you never plan to add a new page to your website without help from the LEANWI website team, the fundamentals of structure still apply to creating accessible website posts and applies to accessible documents, which may be important if you add PDFs to your website.

This tutorial focuses on understanding and managing website heading structure, specifically:

Note that we expect evolution and changes to these the specific tools and methods we use for scanning and creating accessible content on websites to evolve over the coming years. Review documentation regularly and stay tuned for trainings on requirements and best practices specific to library websites.

Heading Structure and Webpage Navigation

Outlining for Organization

Take yourself back to late elementary and middle school. If you had teachers like mine, they spent an impossible number of hours forcing us to re-write our textbooks in outline form, something like this:

Handwritten notes in a notebook about website heading structure and navigation.

[Note: this dates me as being old enough to be handwriting my notes, but I also became the first person in my class to go home and type them up on a computer, which I continued to do in college.]

Outlining on the Internet

Turns out, this outline form is now the backbone of the entire internet – and especially the accessible internet. Each of those key points/letters/Roman numerals represent a navigation cue for a screen reader, a keyboard, or, ideally, for the eye of the person scanning your site looking for information on a specific topic.

Outline structure on the internet comes from HTML tags for “Headings.” Often the visible formatting for headings goes from large [bold] font sizes for Heading 1 (H1) down to the smallest [least bold] font size for Heading 6 (H6). Rarely is H6 used, especially on a library website.

A dropdown menu listing paragraph and heading options, with

Beware the internet crime: using Heading styles to format regular text in a post or text box.

Because computers and screen readers rely on the underlying format code to navigate, never, ever use one of these heading styles to simply change the look of text in your basic post.

Yes, it’s boring. But if you want a beautifully formatted post with different size fonts and styles, you either need to commit to learning HTML/CSS code, or to learning how to use Divi for posts and pages.

Heading Structure and Screen Readers

Screen readers use heading structure to read aloud the main landmarks of a page. This way a user doesn’t need to listen to the entire contents of a longer page when there is just one section they are looking for.

Keyboard navigation allows a user to move between headings only while skipping other text.

A screen reader can also show and read a navigation pane based on this information, like this:

NVDA dialog box titled

The following video is a good way to see navigating headings using a screen reader in action:

Heading Structure in a (WordPress) Post

Making posts is often the bread-and-butter of a library’s interaction with their website. And often those posts have a very basic structure: title, text content, featured image.

In both posts and pages, the title of the post/page is the page’s Heading 1 (H1). No headings are necessary in a short post.

The Short Post

99% of the time, a post in this format will be accessible as long as the featured image has alt text.

Blog post editor showing details for

And this is how it looks to the website visitor:

Book club announcement for

The Longer Post

In cases where a large amount of text and information is included in a post, it is best to break up that information into sections and divide it out with headings. This will improve readability for both traditional website visitors and those using screen readers.

This example uses several Heading 2 (H2) section titles to break up and organize text.

Screenshot of a blog post edit interface showcasing the use of headings and alt-text annotations.

And this is how it looks to a website visitor. Notice how the H2 lines catch the eye for skimming for information: 

Blog post for the Blue Pine Library Summer Reading Program with colorful graphics and event details utilizing Heading 2 structure within the post.

Heading Structure in a (Divi) Page

Most LEANWI webpages are built using the Divi Builder. Divi Builder can also be used on posts.

While it takes more work to learn to use Divi, it does allow much more control over the visual appearance of headings (font, font size, formatting, etc.,) on individual pages.

Your website is set with a structure of defaults for heading styles (somewhat similar to the dropdown menu on posts, but in the main website settings).

WordPress typography customization menu with sliders for text size and line height, font style options, and color selection.

Changing across your site is not a one-and-done change, and would require assistance from the LEANWI website team (websitehelp@librarieswin.org).

However, if you are working in a Divi module that contains text and a heading element, you can make changes on a page-by-page, post-by-post content. This way you can change the look of a header element on your page, but the underlying code tagging at as a <h1>, <h2>, <h3>, etc., won’t change and the screen reader will still be able to navigate it.

Divi module settings interface with highlighted

User interface of Divi's title text customization settings showing color palette, heading levels, font options, and alignment.

Common modules that have the header option include:

Headings in a Document

Documents (Word, Google Docs), spreadsheets, presentations, and PDFs, are much more complex pieces of software than a webpage. Heading structure is less often correctly used in them, but equally important when they are accessed through a website.

Accessible documents are covered in more detail in other tutorials. Specific to document headings:

Word

Heading structure in a Word document is managed in the “Styles” tab in the Home menu. When Heading styles are appropriately applied, it gives a clean, consistent look to the document and makes the document navigable, as viewable in the Navigation Pane (accessed from View > [Show] Navigation Pane).

Screenshot of Microsoft Word with the View tab open and the Navigation Pane enabled.

Screenshot of a Word document titled

Google Docs

A reminder – if you use Google Docs to public documents, install the Grackle Docs add-on to check your document’s accessibility.

Google Docs functions similarly to Word, with the heading structure options in a dropdown menu in the main menu bar.

Screenshot of Google Docs editor showing a headings and the navigation pane for a document on code changes for accessibility settings for online resources.

Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in /srv/users/demo/apps/training-librarieswin-org/public/wp-includes/formatting.php on line 4715