Title: WP HTML5 Outliner
Author: rsborn
Published: <strong>November 28, 2018</strong>
Last modified: January 27, 2020

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/wp-html5-outliner/assets/icon.svg?rev=1982265)

# WP HTML5 Outliner

 By [rsborn](https://profiles.wordpress.org/rsborn/)

[Download](https://downloads.wordpress.org/plugin/wp-html5-outliner.zip)

 * [Details](https://twd.wordpress.org/plugins/wp-html5-outliner/#description)
 * [Reviews](https://twd.wordpress.org/plugins/wp-html5-outliner/#reviews)
 * [Development](https://twd.wordpress.org/plugins/wp-html5-outliner/#developers)

 [Support](https://wordpress.org/support/plugin/wp-html5-outliner/)

## Description

WP HTML5 Outliner (WPH5O) adds an HTML 5 outline plus a heading-level outline to
the WordPress Toolbar.

#### Features

 * Matches the outlines provided by the [W3C Markup Validation Service](https://validator.w3.org/#validate_by_uri+with_options).
   _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

 * [[
 * HTML 5 outline in a Toolbar dropdown box. _Theme_: Twenty Nineteen. _Context_:
   Homepage. _WordPress Version_: 5.0.
 * [[
 * Heading-level outline in a Toolbar dropdown box. _Theme_: Twenty Nineteen. _Context_:
   Homepage. _WordPress Version_: 5.0.
 * [[
 * HTML 5 outline and heading-level outline in a new window. _Theme_: Twenty Nineteen.
   _Context_: Homepage. _WordPress Version_: 5.0.

## FAQ

  What is an HTML 5 outline?

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](https://www.w3.org/TR/html52/sections.html)

  What is a heading-level outline?

A heading-level outline represents the sections of an HTML document. Each section
corresponds to a heading element. Sections may be nested to create subsections.

Sources: [W3C Quality Assurance](https://www.w3.org/QA/Tips/headings), [W3C HTML 5.2 Specification](https://www.w3.org/TR/html52/sections.html)

  Why do these outlines matter?

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](https://www.w3.org/TR/2008/WD-html5-20080610/the-root.html#outlines)),
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](https://wiki.developer.mozilla.org/en-US/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines$revision/1532798#Problems_solved_by_HTML5).

Sources: [W3C Web Accessibility Initiative](https://www.w3.org/WAI/tutorials/page-structure/headings/),
[W3C HTML 5.2 Specification](https://www.w3.org/TR/html52/sections.html)

  Is there developer documentation?

Yes. The source code conforms to [WordPress Inline Documentation Standards](https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/).
Fork this plugin at the [WPH5O GitHub page](https://github.com/ryansborn/WP_HTML5_Outliner).

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WP HTML5 Outliner” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ rsborn ](https://profiles.wordpress.org/rsborn/)

[Translate “WP HTML5 Outliner” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-html5-outliner)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-html5-outliner/),
check out the [SVN repository](https://plugins.svn.wordpress.org/wp-html5-outliner/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-html5-outliner/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-html5-outliner/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3.0

 * Change text domain to plugin slug.
 * Add i18n support to JS files.
 * Edit readme section titled “Why do these outlines matter?”.

#### 1.2.0

 * Add function to load plugin’s text domain.
 * Ensure ‘No outline was created’ message replaces heading-level outline if source
   has no headings.

#### 1.1.0

 * Fix notices for empty headings in an hgroup element that also contains non-heading
   elements.
 * Shorten Toolbar node title to “Outline”.

#### 1.0.0

 * Release the plugin!

## Meta

 *  Version **1.3.0**
 *  Last updated **6 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.3 or higher **
 *  Tested up to **5.3.21**
 *  PHP version ** 5.4.5 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/wp-html5-outliner/)
 * Tags
 * [accessibility](https://twd.wordpress.org/plugins/tags/accessibility/)[HTML5](https://twd.wordpress.org/plugins/tags/html5/)
   [outline](https://twd.wordpress.org/plugins/tags/outline/)
 *  [Advanced View](https://twd.wordpress.org/plugins/wp-html5-outliner/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/wp-html5-outliner/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-html5-outliner/reviews/)

## Contributors

 *   [ rsborn ](https://profiles.wordpress.org/rsborn/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-html5-outliner/)