Skip to content

docs: document Pinned tabs #339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
hongyi-chen wants to merge 2 commits into from
+20 −0
Closed

docs: document Pinned tabs #339

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2033fc3
docs: document Pinned tabs in tabs.mdx
hongyi-chen Jul 17, 2026
51b40a9
Merge branch 'main' into docs/pinned-tabs
hongyi-chen Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions src/content/docs/terminal/windows/tabs.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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**.

@oz-for-oss oz-for-oss Bot Jul 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 [SUGGESTION] Orient readers before the Settings path so the instruction follows the docs style guide for first references to app surfaces.

Suggested change
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**.
Pinning actions ship without default keyboard shortcuts. In the Warp app, go to **Settings** > **Keyboard shortcuts** to assign 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:
Expand Down
Loading