# Application Navigation: Page Outline Rail

A sticky on this page outline rail listing document anchors along a guide line with the active section marked, beside doc content with a code sample.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/page-outline-rail
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Navigation](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/page-outline-rail.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-navigation-page-outline-rail
```

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: lucide-react
- Installs to: `@/components/blocks/application-pro/navigation/page-outline-rail`

## About this block

Page Outline Rail pairs a document with an on this page
outline. The sticky right column, 56 wide and shown from
lg up, lists the anchors along a left guide line:
Overview, Limits by plan, Rate limit headers active with
a filled left border, Handling 429 responses expanded to
two indented subsections (Retry with backoff, Queue
writes), and Best practices, with Suggest an edit and
Back to top links below a rule. Beside it the article
carries real content so every anchor has a target: an
API rate limits heading, an Overview paragraph, a Limits
by plan table for Free, Pro, and Enterprise, a monospace
rate limit headers sample, and a Handling 429 responses
section.

The outline array carries a label, an active flag, and
optional children. The active anchor uses a solid left
border and stronger text while the rest use a transparent
border that fills on hover, and children render indented
under their parent. The rail is position sticky at top-8,
so it reads as a scroll spy while shipping fully static.

## When to use

Reach for this block on any long documentation or
reference page where readers need to jump between
sections. Generate the outline from your rendered
headings and wire the active anchor to an
IntersectionObserver so it tracks the heading in view.

A natural flow around it on an Application Pro page:

**Before**

- [Docs shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)
- [Breadcrumbs with actions](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation)

**After**

- [Help center](https://www.shadcn-ui-blocks.com/blocks/application-pro/help-support)
- [Global search results](https://www.shadcn-ui-blocks.com/blocks/application-pro/filters-and-search)

## What you can display

One strong use is the reference page outline. Other
configurations:

- **Changelog outline.** Anchors become release versions
  with dated subsections.
- **Legal document.** Anchors become numbered clauses for
  a terms or policy page.
- **No subsections.** Ship a flat single level outline
  for shorter pages.

> Tip: the active anchor is a boolean here; wire it to a
> scroll spy so it tracks the section in view as the
> reader moves down the page.

## More in Application Navigation

- [App Switcher Grid](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/app-switcher-grid)
- [Breadcrumb Dropdown Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/breadcrumb-dropdown-blueprint)
- [Breadcrumbs With Actions](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/breadcrumbs-with-actions)
- [Command Palette Open](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/command-palette-open)
- [Context Menu Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/context-menu-blueprint)
- [Global Search Results](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/global-search-results)
- [Help Menu Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/help-menu-blueprint)
- [Jump To Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/jump-to-blueprint)
- [Mega Menu Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/mega-menu-blueprint)
- [Pagination Bar](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/pagination-bar)
- [Pinned Items Rail](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/pinned-items-rail)
- [Recent History Menu Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/recent-history-menu-blueprint)
- [Record Pager Header](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/record-pager-header)
- [Secondary Settings Nav](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/secondary-settings-nav)
- [Section Switcher](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/section-switcher)
- [Sidebar Footer Menu Open](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/sidebar-footer-menu-open)
- [Sidebar Nav Tree](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/sidebar-nav-tree)
- [Sidebar Search Results](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/sidebar-search-results)
- [Tab Bar Mobile](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/tab-bar-mobile)
- [Tab Navigation Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/tab-navigation-panel)
- [Topbar With Command Hint](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/topbar-with-command-hint)
- [Workspace Switcher Open](https://www.shadcn-ui-blocks.com/blocks/application-pro/navigation/workspace-switcher-open)
