Skip to content

Document tab and group pinning #342

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

Merged
johnturcoo merged 2 commits into from
Jul 17, 2026
+37 −2
Merged

Document tab and group pinning #342

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
33bd627
docs: document pinning tabs and tab groups
johnturcoo Jul 17, 2026
41053d2
Merge branch 'main' into john/tab-pinning
johnturcoo 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
39 changes: 37 additions & 2 deletions src/content/docs/terminal/windows/tabs.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Tabs
description: >-
Organize your window into multiple terminal sessions with customizable tabs,
complete with titles and ANSI colors.
Organize terminal sessions with customizable tabs and groups, then pin
important tabs and groups at the front of the tab list.
---
import { Tabs, TabItem } from '@astrojs/starlight/components';
import VideoEmbed from '@components/VideoEmbed.astro';
Expand Down Expand Up @@ -127,6 +127,41 @@ 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**.
:::

## Pin tabs and groups

Pin frequently used tabs or tab groups to keep them at the front of the tab list. Pinned items form a leading section before unpinned tabs and groups, and you can reorder items within the pinned section. Pinning works in both the horizontal tab bar and the [vertical tabs](/terminal/windows/vertical-tabs/) panel. Warp restores the pinned state when you reopen the window.

### Pin a tab

1. Right-click the tab you want to keep at the front.
2. Click **Pin tab**.
Comment on lines +136 to +137

@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.

🧹 [NIT] Numbered procedure steps should end with periods per the docs style guide.

Suggested change
1. Right-click the tab you want to keep at the front.
2. Click **Pin tab**.
1. Right-click the tab you want to keep at the front.
2. Click **Pin tab**.

@johnturcoo johnturcoo Jul 17, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Lol this diff looks identical to before?


Warp moves the tab to the end of the pinned section.

:::note
If the tab belongs to a group, **Pin tab** removes the tab from its group and pins it independently. To keep the group together, pin the group instead.
:::

### Pin a group

1. Right-click the group's header.
2. Click **Pin group**.
Comment on lines +147 to +148

@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.

🧹 [NIT] Numbered procedure steps should end with periods per the docs style guide.

Suggested change
1. Right-click the group's header.
2. Click **Pin group**.
1. Right-click the group's header.
2. Click **Pin group**.

@johnturcoo johnturcoo Jul 17, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Same as above


Warp moves the entire group to the end of the pinned section as one block.

### Unpin a tab or group

To return an item to the unpinned section:

* **Tab** - Right-click the pinned tab, then click **Unpin tab**.
* **Group** - Right-click the pinned group's header, then click **Unpin group**.

Warp moves the item to the beginning of the unpinned section.

:::note
You can assign keyboard shortcuts for pinning or unpinning the active tab or group in **Settings** > **Keyboard shortcuts**.
:::

## 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