[mintlify]

Summary

The table of contents now uses one shared markup across themes. It exposes stable data-layout-item hooks, depth and active-state attributes, and per-theme variant attributes. Its built-in styles sit in a cascade layer, so unlayered custom CSS overrides them.

Changes

• reference/customization/selectors.md: added a "Table of contents" section. It covers the toc-* data-layout-item parts, 0-based data-depth, data-active on items and links, aria-current="location" on the active link, the root data-shell/data-marker/data-look values, and the cascade-layer override behavior.
• The existing .toc-item[data-active] and .toc-item[data-active-deepest] rows are still accurate, so I left them unchanged.

Validation

• git diff --check passed.
• npm test, npm run check, and npm run build could not run because the ajv dev dependency isn't installed. This also fails on main.

The existing sync workflow distributes the canonical skill after merge.

Docs pages that may need updates

• Custom CSS/scripts page (customize/custom-scripts): could list the new TOC data-layout-item hooks.

Needs confirmation

• Whether the data-layout-item TOC hooks should be treated as stable public hooks.

---

Note

Low Risk
Documentation-only change to agent skill reference; no runtime or product code affected.

Overview
Documents the unified table of contents customization surface in the Mintlify agent skill reference (selectors.md).

Adds a Table of contents section describing stable [data-layout-item="toc-*"] parts on #table-of-contents, including depth via toc-item[data-depth], active/ancestor styling via data-active and aria-current="location", and per-theme root attributes (data-shell, data-marker, data-look). It also notes that built-in TOC CSS lives in a cascade layer with :where(), so custom unlayered CSS can override defaults. Existing .toc-item[data-active] state-attribute rows are unchanged.

^{Reviewed by Cursor Bugbot for commit f2c4c9e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Mintlify Docs	🟢 Ready	View Preview	Oct 24, 2026, 9:14 PM