diff --git a/docs/docs.json b/docs/docs.json
index 40fa5eb0e..770e39e21 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -33,7 +33,8 @@
"features/memory",
"features/sync-to-cloud",
"features/llm-chat-hub",
- "features/ad-blocking"
+ "features/ad-blocking",
+ "features/vertical-tabs"
]
},
{
diff --git a/docs/features/vertical-tabs.mdx b/docs/features/vertical-tabs.mdx
new file mode 100644
index 000000000..24e99c978
--- /dev/null
+++ b/docs/features/vertical-tabs.mdx
@@ -0,0 +1,60 @@
+---
+title: "Vertical Tabs"
+description: "Move your tabs to the side for a cleaner, more organized browsing experience"
+---
+
+BrowserOS supports vertical tabs — a side panel that lists all your open tabs along the left edge of the browser window. Instead of shrinking tab titles into a cramped horizontal strip, vertical tabs give each tab its own full-width row so you can read titles at a glance, even with dozens of tabs open.
+
+## Why Vertical Tabs?
+
+Modern screens are wide, not tall. A horizontal tab bar wastes vertical space you could use for content, and tabs quickly become unreadable as they shrink. Vertical tabs solve both problems:
+
+
+
+ Tabs stack vertically with full-width labels, so you always know what is open — no squinting at favicons.
+
+
+ Open 30, 50, or 100 tabs without the strip becoming unusable. The side panel scrolls naturally.
+
+
+ The horizontal tab bar disappears, giving web pages more room on widescreen monitors.
+
+
+ Combine vertical tabs with tab groups to visually separate work, research, and personal browsing.
+
+
+
+## Enabling Vertical Tabs
+
+Toggle vertical tabs on or off from the Customization settings page.
+
+
+
+ Go to `chrome://browseros/settings` in the address bar.
+
+
+ In the left sidebar, select **Customization**.
+
+
+ Flip the **Use Vertical Tabs** switch to on. The browser immediately moves your tabs to a side panel.
+
+
+
+
+
+
+
+To switch back, return to the same setting and turn the toggle off. Your tabs move back to the horizontal strip instantly.
+
+## How It Works
+
+When vertical tabs are enabled, the tab strip relocates from the top of the window to a collapsible side panel on the left. Each tab is displayed as a row showing the page favicon and full title.
+
+- **Click** a tab row to switch to it.
+- **Right-click** a tab for the standard context menu (pin, mute, close, move to group).
+- **Drag** tabs up or down to reorder them, or drag them into and out of tab groups.
+- The panel can be **collapsed** to show only favicons, freeing up even more horizontal space.
+
+## Vertical Tabs + Tab Groups
+
+Vertical tabs pair naturally with [tab groups](/features/workflows). Groups appear as collapsible sections in the side panel, making it easy to keep projects separate and fold away tabs you are not actively using.
diff --git a/docs/images/features--vertical-tabs-setting.png b/docs/images/features--vertical-tabs-setting.png
new file mode 100644
index 000000000..d9a33c9f0
--- /dev/null
+++ b/docs/images/features--vertical-tabs-setting.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4875e3c98a1f7584e94a2a412908f982b7903946c0ff7f67cba1e9cf74ce7b93
+size 240299