WP HTML5 Outliner (WPH5O) adds an HTML 5 outline plus a heading-level outline to the WordPress Toolbar.
- WordPress 3.3 or higher
- PHP 5.4.5 or higher
- Matches the outlines provided by the W3C Markup Validation Service. Caveat: In an HTML 5 outline, the W3C validator may hide some of the headings in an
<hgroup>if any of them are empty. WPH5O will not. This difference is presentational, not structural. - Adds an ‘Outline’ node to the Toolbar. Outlines are displayed in a dropdown box, with the option to view them in a new browser window.
- Runs only on pages or posts the user can edit. Administrators can view outlines for any page or post. Administration Screens are not outlined.
Screenshots #1 and #2 show the 'Outline' dropdown box in the Toolbar. At the top of the dropdown, clicking 'Structural (HTML5)' or 'Heading-level' selects the outline to display. Clicking the icon in the top right corner opens a new window that displays both outlines, as shown in screenshot #3. An HTML 5 outline appears in #1, a heading-level outline in #2.
An HTML 5 outline represents the sections of an HTML document. Each section corresponds to an element from one of three categories:
- Sectioning root:
<blockquote>,<body>,<details>,<dialog>,<fieldset>,<figure>,<td> - Sectioning content:
<article>,<aside>,<nav>,<section> - Heading content:
<h1>,<h2>,<h3>,<h4>,<h5>,<h6>
Sections may be nested to create subsections.
Source: W3C HTML 5.2 Specification
A heading-level outline also represents the sections of an HTML document, but each section corresponds to a heading element. Sections may still be nested to create subsections.
Sources: W3C Quality Assurance, W3C HTML 5.2 Specification
Each outline shows how well a page meets web standards for marking up document structure. User agents, particularly screen readers, use the heading-level outline to aid navigation. However, no web browsers or assistive technologies make use of the HTML 5 outline. So, really, the question is this: Why does that outline matter?
Although user agents still haven’t implemented the HTML 5 outline (introduced in 2008), developers aren’t giving up on it. And they have their reasons. The MDN web docs highlight some problems solved by HTML 5 document structure.
Sources: W3C Web Accessibility Initiative, W3C HTML 5.2 Specification
- Hat tip to @dominykas. The source for h5o-js kickstarted this implementation of the HTML 5 outline algorithm.


