Reading Progress Bar & TOC on mobile phone

Reading Progress & Table of Contents Plugin: Now Live on WordPress.org

When I build software for clients, it’s usually solving a very specific problem. Every so often, though, Reading Progress & Table of Contents Plugin: Now Live on WordPress.org

A super simple thing I’ve built is now officially out in the wild. Just a handy little plugin, made properly and designed to help UX and indexability.

Erryn Reading Progress & Table of Contents is live in the WordPress plugin directory.

The idea started from something simple: long-form content is much easier to navigate when people can see where they are, what comes next, and how much is left, this is especially important on a mobile device in a long piece of content or a product page. Now plenty of plugins already handle one part of that, but I wanted something that combined reading progress and navigation without turning a straightforward job into another miniature software platform.

The plugin automatically builds a table of contents from the headings on a page or post, tracks reading progress as somebody scrolls and highlights the section they’re currently reading.

The critical thing about this plugin is that it will be actively supported, there’s no “upgrade to premium” nonsense, plus, coming from a cyber security and optimisation background, it’s been built to be featherweight and secure on your website, with structured data and WCAG contrast checker built in (I’m all about speed, ranking and compliance).

There are two main layouts: a horizontal reading progress bar and an expandable side rail. Both are designed to stay out of the way until they’re useful, with automatic responsive touch behaviour for smaller screens and mobile devices.

It also includes:

  • Automatic heading detection from H2 to H6
  • ItemList structured data
  • Rank Math, Yoast, AIOSEO table of contents recognition
  • WPML, Polylang and right-to-left language support
  • WCAG contrast checker
  • Manual anchor support where more control is needed
  • Horizontal progress bar and side-rail layouts
  • Current-section highlighting while scrolling
  • Automatic light and dark mode support
  • Theme-aware colours with custom colour options
  • Per-post controls

There is no jQuery dependency, no frontend framework, no external tracking and no random API calls disappearing off somewhere to contemplate their purpose in life, track you or slow down your website. The plugin does the job locally and leaves the rest of the page alone.

For most sites, setup is deliberately uneventful. Install it, activate it and it should detect the content structure automatically. The additional settings are there for sites with fixed headers, unusual templates or more particular styling requirements, rather than because everybody should need seventeen switches before a progress bar can move from left to right.

This plugin is pretty basic but will be expanded on with extra features and layouts in-between more involved projects.

It is free and available now from the official WordPress plugin directory.

View Erryn Reading Progress & Table of Contents on WordPress.org