diff --git a/docs-app/components/WikiNavIcon.tsx b/docs-app/components/WikiNavIcon.tsx
new file mode 100644
index 0000000..3dd7b74
--- /dev/null
+++ b/docs-app/components/WikiNavIcon.tsx
@@ -0,0 +1,39 @@
+// Sidebar icon names follow wiki slugs, not display titles (which can vary by version).
+const ICONS: Record<string, string> = {
+  '': 'overview',
+  'bar-chart': 'bar',
+  'heatmap-chart': 'heatmap',
+  'histogram-chart': 'histogram',
+  'line-chart': 'line',
+  'pie-chart': 'pie',
+  'radar-chart': 'radar',
+  'ring-gauge-chart': 'ring-gauge',
+  'scatter-chart': 'scatter',
+  'segmented-ring-gauge-chart': 'segmented-ring',
+  'stacked-area-chart': 'stacked-area',
+  'stacked-bar-chart': 'stacked-bar',
+  customization: 'customization',
+  gradients: 'gradients',
+  migration: 'migration',
+  screenshots: 'screenshots',
+};
+
+export function WikiNavIcon({ slug, active }: { slug: string; active: boolean }) {
+  const icon = ICONS[slug] ?? 'document';
+
+  return (
+    <svg
+      aria-hidden="true"
+      focusable="false"
+      viewBox="0 0 24 24"
+      className={`h-[18px] w-[18px] shrink-0 ${active ? 'text-[var(--color-primary)]' : 'text-[var(--text-muted)]'}`}
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="1.7"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    >
+      <use href={`/wiki-nav-icons.svg#${icon}`} />
+    </svg>
+  );
+}
diff --git a/docs-app/components/WikiSidebar.tsx b/docs-app/components/WikiSidebar.tsx
index fb3b9da..7eb9040 100644
--- a/docs-app/components/WikiSidebar.tsx
+++ b/docs-app/components/WikiSidebar.tsx
@@ -3,6 +3,7 @@
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
 import { useRef } from 'react';
+import { WikiNavIcon } from './WikiNavIcon';
 import type { NavItem } from '@/lib/types';
 import { useScrollActiveIntoView } from '@/lib/use-scroll-active-into-view';
 import { cn, stickySidebar } from '@/lib/utils';
@@ -44,7 +45,10 @@ export function WikiSidebar({ navigation }: WikiSidebarProps) {
               )}
               aria-current={isActive(item.path) ? 'page' : undefined}
             >
-              {item.title}
+              <span className="flex min-w-0 items-center gap-2.5">
+                <WikiNavIcon slug={item.slug} active={isActive(item.path)} />
+                <span className="min-w-0">{item.title}</span>
+              </span>
               {item.badgeCount ? (
                 <span className="rounded-full bg-[var(--color-warning)] px-1.5 py-0.5 text-[10px] font-semibold leading-none text-[var(--bg-primary)]">
                   {item.badgeCount}
diff --git a/docs-app/public/wiki-nav-icons.svg b/docs-app/public/wiki-nav-icons.svg
new file mode 100644
index 0000000..003a7e6
--- /dev/null
+++ b/docs-app/public/wiki-nav-icons.svg
@@ -0,0 +1,82 @@
+<svg xmlns="http://www.w3.org/2000/svg">
+  <!-- Outline drawings live here rather than in the React sidebar. -->
+  <symbol id="overview" viewBox="0 0 24 24">
+    <rect x="3.5" y="4" width="17" height="16" rx="2.5"/>
+    <path d="m7 15 3-3 3 2 4-5"/>
+  </symbol>
+  <symbol id="bar" viewBox="0 0 24 24">
+    <path d="M3 20.5h18M5 20V12h3v8M11 20V8h3v12M17 20V4h3v16"/>
+  </symbol>
+  <symbol id="heatmap" viewBox="0 0 24 24">
+    <rect x="3.5" y="3.5" width="5" height="5" rx=".7"/>
+    <rect x="9.5" y="3.5" width="5" height="5" rx=".7"/>
+    <rect x="15.5" y="3.5" width="5" height="5" rx=".7"/>
+    <rect x="3.5" y="9.5" width="5" height="5" rx=".7"/>
+    <rect x="9.5" y="9.5" width="5" height="5" rx=".7"/>
+    <rect x="15.5" y="9.5" width="5" height="5" rx=".7"/>
+    <rect x="3.5" y="15.5" width="5" height="5" rx=".7"/>
+    <rect x="9.5" y="15.5" width="5" height="5" rx=".7"/>
+    <rect x="15.5" y="15.5" width="5" height="5" rx=".7"/>
+  </symbol>
+  <symbol id="histogram" viewBox="0 0 24 24">
+    <path d="M3 20.5h18M4 20v-6h3v6M7 20V9h3v11M10 20V4h4v16M14 20V10h3v10M17 20v-5h3v5"/>
+  </symbol>
+  <symbol id="line" viewBox="0 0 24 24">
+    <path d="M3.5 4v16.5H21M6.5 15l4-5 3.5 2.5 5-7"/>
+    <circle cx="10.5" cy="10" r=".75"/>
+    <circle cx="14" cy="12.5" r=".75"/>
+  </symbol>
+  <symbol id="pie" viewBox="0 0 24 24">
+    <circle cx="12" cy="12" r="9"/>
+    <path d="M12 3v9h9"/>
+  </symbol>
+  <symbol id="radar" viewBox="0 0 24 24">
+    <path d="m12 2.5 9 6.5-3.5 10.5h-11L3 9l9-6.5Z"/>
+    <path d="m12 7 4.8 3.5-1.8 5.5H9l-1.8-5.5L12 7Z"/>
+    <path d="M12 2.5V7m9 2-4.2 1.5m.7 9-2.5-3.5m-8.5 3.5L9 16M3 9l4.2 1.5"/>
+  </symbol>
+  <symbol id="ring-gauge" viewBox="0 0 24 24">
+    <circle cx="12" cy="12" r="8.5"/>
+    <circle cx="12" cy="12" r="4.5"/>
+    <path d="M12 3.5a8.5 8.5 0 0 1 8.5 8.5"/>
+  </symbol>
+  <symbol id="scatter" viewBox="0 0 24 24">
+    <path d="M3.5 3.5v17h17"/>
+    <circle cx="8" cy="15.5" r="1.4"/>
+    <circle cx="11.5" cy="10.5" r="2"/>
+    <circle cx="17.5" cy="7" r="2.6"/>
+    <circle cx="18" cy="16" r="1.2"/>
+  </symbol>
+  <symbol id="segmented-ring" viewBox="0 0 24 24">
+    <path d="M12 3.5a8.5 8.5 0 0 1 7.3 4.2M20.3 11a8.5 8.5 0 0 1-4.5 8.4M12.6 20.5A8.5 8.5 0 0 1 4.1 15M3.5 11.5A8.5 8.5 0 0 1 8.7 4.2"/>
+    <circle cx="12" cy="12" r="4.5"/>
+  </symbol>
+  <symbol id="stacked-area" viewBox="0 0 24 24">
+    <path d="M3.5 20.5h17M4 20V15l4.5-3 4 2 4.5-4 3 1.5V20"/>
+    <path d="M4 15V10l4.5-3 4 2 4.5-5 3 2v5.5"/>
+  </symbol>
+  <symbol id="stacked-bar" viewBox="0 0 24 24">
+    <path d="M3 20.5h18M5 20V9h3v11M11 20V4h3v16M17 20V7h3v13M5 15h3m3-4h3m3 3h3"/>
+  </symbol>
+  <symbol id="customization" viewBox="0 0 24 24">
+    <path d="M4 6h4m4 0h8M4 12h10m4 0h2M4 18h2m4 0h10"/>
+    <circle cx="10" cy="6" r="2"/>
+    <circle cx="16" cy="12" r="2"/>
+    <circle cx="8" cy="18" r="2"/>
+  </symbol>
+  <symbol id="gradients" viewBox="0 0 24 24">
+    <rect x="3" y="4" width="18" height="16" rx="2"/>
+    <path d="M7 4v16m4-16v16m4-16v16m4-16v16"/>
+  </symbol>
+  <symbol id="migration" viewBox="0 0 24 24">
+    <path d="M4 8h16m-4-4 4 4-4 4M20 16H4m4-4-4 4 4 4"/>
+  </symbol>
+  <symbol id="screenshots" viewBox="0 0 24 24">
+    <rect x="3" y="4" width="18" height="16" rx="2"/>
+    <circle cx="8" cy="9" r="1.5"/>
+    <path d="m4.5 18 5-5 3.5 3 3.5-4 3 3"/>
+  </symbol>
+  <symbol id="document" viewBox="0 0 24 24">
+    <path d="M6 3.5h9l4 4V20H6zM15 3.5V8h4M9 12h7M9 16h7"/>
+  </symbol>
+</svg>