Adrian Roselli
Read post

heading‍offset is Not the Document Outline Algorithm

The `headingoffset` HTML attribute, recently announced for Firefox behind a flag, is being mistakenly celebrated as a revival of the long-dead Document Outline Algorithm. It is not. `headingoffset` lets authors manually offset heading levels for descendants of a given node — useful for content reuse — but it still requires intentional author decisions. The browser gains no new understanding of content structure. Key constraints: values must be non-negative integers between 0 and 8, values over 8 max at level 9, and `headingreset` can override it. Authors should not use it until browser support is confirmed, and should not expect it to automatically resolve heading level problems in imported or user-generated content, as doing so risks WCAG violations.

    #html#accessibility
Jun 11•4m read time•From adrianroselli.com
Post cover image
Table of contents
Background # anchorheadingoffset # anchorRecap # anchorRelated # anchorTagsOther PostsNo comments? Be the first!
86.3K Impressions
Adrian Roselli's image
Adrian Roselli

Adrian Roselli is a web developer, accessibility advocate, and expert in web standards. Readers can ...

37 Followers

•

199 Upvotes

Would you recommend this post?

Copy link
WhatsApp
Facebook
X
New Squad
  • © 2026 Daily Dev Ltd.
  • Guidelines
  • Explore
  • Tags
  • Sources
  • Squads
  • Leaderboard