diff --git a/docs/images/settings/settings-hub-grouped.png b/docs/images/settings/settings-hub-grouped.png
new file mode 100644
index 00000000..236c3290
Binary files /dev/null and b/docs/images/settings/settings-hub-grouped.png differ
diff --git a/docs/images/settings/settings-node-scope.png b/docs/images/settings/settings-node-scope.png
new file mode 100644
index 00000000..70f3dc70
Binary files /dev/null and b/docs/images/settings/settings-node-scope.png differ
diff --git a/docs/images/settings/settings-search.png b/docs/images/settings/settings-search.png
new file mode 100644
index 00000000..763e8116
Binary files /dev/null and b/docs/images/settings/settings-search.png differ
diff --git a/docs/reference/settings.mdx b/docs/reference/settings.mdx
index 43618eb1..828d7c7f 100644
--- a/docs/reference/settings.mdx
+++ b/docs/reference/settings.mdx
@@ -3,10 +3,37 @@ title: Settings Reference
description: Complete reference for every option in the Sencho Settings Hub.
---
-Open the Settings Hub by clicking the **Profile** icon in the top bar and selecting **Settings**. The left sidebar lists all available sections. Some sections show a lock icon when they require a higher license tier.
+Open the Settings Hub by clicking the **Profile** icon in the top bar and selecting **Settings**. The sidebar groups every section into four themes so related settings live together.
-
+
+
+
+### Sidebar groups
+
+| Group | What it covers |
+|-------|----------------|
+| **Identity** | Account, License, Users, SSO, API Tokens |
+| **System** (node-scoped) | System Limits, Registries, Nodes |
+| **Alerts** | Notifications, Routing, Webhooks |
+| **Advanced** | Labels, Security, Developer, App Store, Support, About |
+
+Sections that require a higher license tier show a tier chip (`SKIPPER` or `ADMIRAL`) next to their name. Admin-only sections stay hidden for non-admins.
+
+### Quick search
+
+Click **Filter settings** at the top of the sidebar, or press `Ctrl+K` / `⌘K` while the hub is open, to open the command palette. Type any section name, keyword, or synonym (for example, `saml` finds SSO and `trivy` finds Security) and press Enter to jump to it.
+
+
+
+
+
+### Scope breadcrumb
+
+The content pane shows a breadcrumb such as `SETTINGS › SYSTEM › SYSTEM LIMITS`. For node-scoped sections the breadcrumb appends the active node name (for example, `LOCAL (NODE-SCOPED)`) so you always know which node you are editing.
+
+
+
---
diff --git a/e2e/mfa.spec.ts b/e2e/mfa.spec.ts
index ec20e13a..3e3488fd 100644
--- a/e2e/mfa.spec.ts
+++ b/e2e/mfa.spec.ts
@@ -26,7 +26,7 @@ async function logout(page: Page) {
async function openAccountSettings(page: Page) {
await page.getByRole('button', { name: /profile/i }).click();
await page.getByRole('button', { name: /settings/i }).click();
- await expect(page.getByRole('heading', { name: /Account & Security/i })).toBeVisible();
+ await expect(page.getByRole('heading', { name: /^Account$/i })).toBeVisible();
}
/** Fill a login form (no MFA branch). */
diff --git a/frontend/src/components/ApiTokensSection.tsx b/frontend/src/components/ApiTokensSection.tsx
index 0a3a8ac2..9745d590 100644
--- a/frontend/src/components/ApiTokensSection.tsx
+++ b/frontend/src/components/ApiTokensSection.tsx
@@ -10,7 +10,6 @@ import { toast } from '@/components/ui/toast-store';
import { apiFetch } from '@/lib/api';
import { AdmiralGate } from './AdmiralGate';
import { CapabilityGate } from './CapabilityGate';
-import { TierBadge } from './TierBadge';
import { Zap, Plus, Copy, Trash2, CheckCircle, RefreshCw, Clock } from 'lucide-react';
interface ApiTokenListItem {
@@ -132,15 +131,7 @@ export function ApiTokensSection() {
-
-
-
- API Tokens
-
-
- Generate scoped tokens for CI/CD pipelines, scripts, and automation.
-