# Application Accessibility: Heading Outline Tree

Indented document heading tree with landmark chips, level tags, and issue badges for skipped levels, empty headings, and a duplicate H1.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/heading-outline-tree
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Accessibility](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility)
- Created: 2026-07-03
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/heading-outline-tree.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-accessibility-heading-outline-tree
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, radix-ui
- shadcn/ui components: badge
- Installs to: `@/components/blocks/application-pro/accessibility/heading-outline-tree`

## About this block

Heading Outline Tree is the document structure
inspector for the Acme projects dashboard. A landmarks
strip lists the five detected regions as chips pairing
the ARIA role with a plain label, then a ruled tree
shows every heading on the page: a level tag, the
heading text indented by depth, and a pass or issue
badge. Three rows carry fix hints: an H4 that skips a
level, an icon only heading with no text, and a second
H1 rendered by the sidebar wordmark.

Headings are one typed array with a level union, and
indentation comes from a Record keyed by that union, so
depth can never drift from the data. The flagged level
tag flips to the destructive fill, which makes broken
rows scannable before you read a single hint.

## When to use

Reach for this block on the accessibility or audit page
of a settings area, wired to a DOM crawl of the page
under review. Screen reader users navigate by headings
first, so fix flagged rows before anything visual.

A natural flow around it on an Application Pro page:

**Before**

- [App shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)

**After**

- [A11y checklist panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility)
- [Screen-reader labels table](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility)

## What you can display

One strong use is the per page heading structure audit.
Other outline shapes:

- **Landmark coverage report.** Regions only, flagging
  content that sits outside any landmark.
- **Docs table of contents lint.** The same tree run
  against generated documentation pages.
- **Before and after diff.** Two trees side by side
  showing the structure a refactor fixed.

> Tip: crawl the rendered DOM, not the source; portals
> and conditional sections often inject the headings
> that break the outline.

## More in Application Accessibility

- [A11y Checklist Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/a11y-checklist-panel)
- [A11y Issue Trends](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/a11y-issue-trends)
- [A11y Preferences Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/a11y-preferences-panel)
- [Alt Text Review Queue](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/alt-text-review-queue)
- [Assistive Tech Matrix](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/assistive-tech-matrix)
- [Conformance Report Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/conformance-report-card)
- [Contrast Checker Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/contrast-checker-card)
- [Focus Order Inspector](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/focus-order-inspector)
- [Keyboard Nav Guide](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/keyboard-nav-guide)
- [Live Region Log](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/live-region-log)
- [Media Captions Audit](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/media-captions-audit)
- [Reduced Motion Audit](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/reduced-motion-audit)
- [Screen Reader Labels Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/screen-reader-labels-table)
- [Touch Target Audit](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/touch-target-audit)
- [Zoom Reflow Audit](https://www.shadcn-ui-blocks.com/blocks/application-pro/accessibility/zoom-reflow-audit)
