Better Navigation with Starlight Sidebar Topics

Jan 7, 2026

My Name

Content Creator

As your documentation grows, the sidebar can become cluttered. starlight-sidebar-topics allows you to organize your sidebar items into distinct sections with icons, improving discoverability.

Key Benefits

Section Headers: Group links under clear headers (e.g., “Concepts”, “Guides”, “API”).
Icons: Add visual cues to your sidebar sections.
Collapsible: Helps keep the navigation clean.

Setup

npm install starlight-sidebar-topics

In your configuration:

import starlightSidebarTopics from 'starlight-sidebar-topics';

// ...
plugins: [
  starlightSidebarTopics([
    {
      label: 'Getting Started',
      icon: 'rocket',
      items: ['intro', 'installation'],
    },
    {
      label: 'Core Concepts',
      icon: 'open-book',
      items: ['concepts/architecture', 'concepts/data-flow'],
    },
  ]),
],

This plugin completely transforms how users navigate your site structure.