diff --git a/docs/architecture.md b/docs/architecture.md
index 2547e83..1d20660 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -1,3 +1,6 @@
+Section: Reference
+Order: 410
+
 # Architecture
 
 Orbit is a small, modular React app. No framework magic — a thin IRC layer feeds a zustand store,
diff --git a/docs/branding.md b/docs/branding.md
index cacbabb..cb5866b 100644
--- a/docs/branding.md
+++ b/docs/branding.md
@@ -1,3 +1,6 @@
+Section: Configuration
+Order: 110
+
 # Branding & themes
 
 Everything that ties Orbit to a particular network or brand lives in
diff --git a/docs/compiled-plugins.md b/docs/compiled-plugins.md
index 481a088..9f3d943 100644
--- a/docs/compiled-plugins.md
+++ b/docs/compiled-plugins.md
@@ -1,3 +1,6 @@
+Section: Plugins
+Order: 210
+
 # Compiled plugins
 
 A quick `.js` plugin (see [Plugin system](/docs/plugins/)) is great for small
diff --git a/docs/config.md b/docs/config.md
index a27c234..5f22c34 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -1,3 +1,6 @@
+Section: Configuration
+Order: 100
+
 # config.json reference
 
 Orbit is configured at **runtime** by `config.json`. It is fetched on startup, deep-merged over the
diff --git a/docs/deploy.md b/docs/deploy.md
index 5cdd37c..662133c 100644
--- a/docs/deploy.md
+++ b/docs/deploy.md
@@ -1,3 +1,6 @@
+Section: Self-hosting
+Order: 300
+
 # Build & deploy
 
 Orbit builds to a **static** `dist/` you can serve from any web server.
diff --git a/docs/ircv3.md b/docs/ircv3.md
index becf984..dae77f4 100644
--- a/docs/ircv3.md
+++ b/docs/ircv3.md
@@ -1,3 +1,6 @@
+Section: Reference
+Order: 400
+
 # IRCv3 capabilities
 
 Orbit negotiates the following capabilities when the server advertises them. Most features degrade
diff --git a/docs/overview.md b/docs/overview.md
index d0680a7..f34f153 100644
--- a/docs/overview.md
+++ b/docs/overview.md
@@ -1,3 +1,6 @@
+Section: Getting started
+Order: 10
+
 # Overview
 
 **Orbit** is a modern web client for **IRC** — the open chat protocol that has quietly run
diff --git a/docs/plugins.md b/docs/plugins.md
index 1f3c259..41ed32e 100644
--- a/docs/plugins.md
+++ b/docs/plugins.md
@@ -1,3 +1,6 @@
+Section: Plugins
+Order: 200
+
 # Plugin system
 
 Orbit has a small, **operator-controlled** plugin system. A deployment lists
diff --git a/docs/push-to-deploy.md b/docs/push-to-deploy.md
index 436a847..daa1536 100644
--- a/docs/push-to-deploy.md
+++ b/docs/push-to-deploy.md
@@ -1,3 +1,6 @@
+Section: Self-hosting
+Order: 310
+
 # Push-to-deploy
 
 Orbit ships its own self-hosted git workflow: a `git push` runs the tests, builds, and publishes —
diff --git a/docs/quick-start.md b/docs/quick-start.md
index 37e6128..cf34f3e 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -1,3 +1,6 @@
+Section: Getting started
+Order: 20
+
 # Quick start
 
 Run your own Orbit in about a minute.
diff --git a/wiki/commands.md b/wiki/commands.md
index 556345e..64c0084 100644
--- a/wiki/commands.md
+++ b/wiki/commands.md
@@ -1,3 +1,5 @@
+Order: 10
+
 # Slash commands
 
 Type these in the composer. Anything not starting with `/` is sent as a message.
diff --git a/wiki/formatting.md b/wiki/formatting.md
index b3e4294..c079cea 100644
--- a/wiki/formatting.md
+++ b/wiki/formatting.md
@@ -1,3 +1,5 @@
+Order: 20
+
 # mIRC formatting
 
 Orbit renders and lets you compose classic IRC formatting. Use the composer's toolbar (**B** / *I* /
diff --git a/wiki/orbit-channel.md b/wiki/orbit-channel.md
index 2d8638c..09725e5 100644
--- a/wiki/orbit-channel.md
+++ b/wiki/orbit-channel.md
@@ -1,3 +1,5 @@
+Order: 40
+
 # The #orbit channel & bot
 
 **#orbit** is the project's live IRC channel. A bot named **`Pulsar`** stays connected there and does
diff --git a/wiki/themes.md b/wiki/themes.md
index 9b34661..8e074a1 100644
--- a/wiki/themes.md
+++ b/wiki/themes.md
@@ -1,3 +1,5 @@
+Order: 30
+
 # Themes
 
 Switch in **Settings → Appearance**. Four themes ship with Orbit:
diff --git a/wiki/troubleshooting.md b/wiki/troubleshooting.md
index dad1b76..413e7cd 100644
--- a/wiki/troubleshooting.md
+++ b/wiki/troubleshooting.md
@@ -1,3 +1,5 @@
+Order: 50
+
 # Troubleshooting
 
 ## "Connexion fermée" / the socket closes immediately