From 2033fc39c86a359fe01fe82cfbee8fa29221fa0a Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Fri, 17 Jul 2026 17:09:57 +0000 Subject: [PATCH] docs: document Pinned tabs in tabs.mdx Pinned tabs (the PinnedTabs feature flag) went GA. Document how to pin and unpin individual tabs and whole tab groups from the tab right-click menu, and note the keyless keyboard shortcuts. Co-Authored-By: Oz --- src/content/docs/terminal/windows/tabs.mdx | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/src/content/docs/terminal/windows/tabs.mdx b/src/content/docs/terminal/windows/tabs.mdx index a3a4798f3..15f8b71cd 100644 --- a/src/content/docs/terminal/windows/tabs.mdx +++ b/src/content/docs/terminal/windows/tabs.mdx @@ -127,6 +127,26 @@ Click a group's header to collapse or expand it. Collapsed groups hide their mem You can assign keyboard shortcuts for creating a group from the active or selected tabs and for removing tabs from a group in **Settings** > **Keyboard shortcuts**. ::: +## Pinned tabs + +Pin the tabs and tab groups you rely on so they stay at the front of the tab bar and are protected from reordering. A pinned tab keeps its position when you open, close, move, or drag other tabs, which keeps your most important sessions in a predictable spot. Pinning works in both the horizontal tab bar and the [vertical tabs](/terminal/windows/vertical-tabs/) panel. + +### Pin or unpin a tab + +* Right-click a tab and choose **Pin tab**. The tab moves to the front of the tab bar and stays there. +* Right-click a pinned tab and choose **Unpin tab** to unpin it. The tab moves back to the start of the unpinned tabs. + +Pinning a tab that belongs to a [group](#tab-groups) removes it from the group first, because pinning a tab and pinning a group are independent. + +### Pin or unpin a tab group + +* Right-click a [tab group's](#tab-groups) header and choose **Pin group**. The group keeps its member tabs together and moves to the front of the tab bar. +* Right-click a pinned group's header and choose **Unpin group** to unpin it. + +### Keyboard shortcuts + +Pinning actions ship without default keyboard shortcuts. Assign your own in **Settings** > **Keyboard shortcuts** for **Pin current tab**, **Unpin current tab**, **Pin current tab group**, and **Unpin current tab group**. + ## Move a tab to another window You can pull a tab out of the tab bar to reorganize your windows, similar to a web browser: