> For the complete documentation index, see [llms.txt](/llms.txt). > Markdown versions of each page are available by appending .md to any URL. # Tabs Organize your window into multiple terminal sessions with customizable tabs, complete with titles and ANSI colors. Note New Tabs will default to the active Tabs’ current [Working Directory](/terminal/more-features/working-directory/) and the actual color values will be automatically derived from your Warp [Theme](/terminal/appearance/themes/). ## How to use Tabs - [macOS](#tab-panel-833) - [Windows](#tab-panel-834) - [Linux](#tab-panel-835) - Right-click on the new Tab button `+` to make a new tab, restore closed tab, or run a saved [Launch Configuration](/terminal/sessions/launch-configurations/). - Open a new Tab with `CMD-T` or by clicking on the `+` in the top bar. - Close the current Tab with `CMD-W` or by clicking on the `X` on hover over a Tab. - Reopen closed tabs with `SHIFT-CMD-T`. - Move a Tab to the Left / Right with `CTRL-SHIFT-LEFT` / `CTRL-SHIFT-RIGHT` or by clicking and dragging a Tab. - Activate the Previous / Next Tab with `SHIFT-CMD-{` / `SHIFT-CMD-}` or by clicking a Tab. - Activate the first through eighth Tabs with `CMD-1` thru `CMD-8`. - Switch to the last Tab with `CMD-9`. - Double-click a Tab to rename it. - Right-clicking on a Tab reveals more options you can explore within the [Command Palette](/terminal/command-palette/) or [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/#fundamentals). - Right-click on the new Tab button `+` to make a new tab, restore closed tab, or run a saved [Launch Configuration](/terminal/sessions/launch-configurations/). - Open a new Tab with `CTRL-SHIFT-T` or by clicking on the `+` in the top bar. - Close the current Tab with `CTRL-SHIFT-W` or by clicking on the `x` on hover over a Tab. - Reopen closed tabs with `CTRL-ALT-T`. - Move a Tab to the Left / Right with `CTRL-SHIFT-LEFT` / `CTRL-SHIFT-RIGHT` or by clicking and dragging a Tab. - Activate the Previous / Next Tab with `CTRL-PGUP` / `CTRL-PGDN` or by clicking a Tab. - Activate the first through eighth Tabs with `CTRL-1` thru `CTRL-8`. - Switch to the last Tab with `CTRL-9`. - Double-click a Tab to rename it. - Right-clicking on a Tab reveals more options you can explore within the [Command Palette](/terminal/command-palette/) or [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/#fundamentals). - Right-click on the new Tab button `+` to make a new tab, restore closed tab, or run a saved [Launch Configuration](/terminal/sessions/launch-configurations/). - Open a new Tab with `CTRL-SHIFT-T` or by clicking on the `+` in the top bar. - Close the current Tab with `CTRL-SHIFT-W` or by clicking on the `x` on hover over a Tab. - Reopen closed tabs with `CTRL-ALT-T`. - Move a Tab to the Left / Right with `CTRL-SHIFT-LEFT` / `CTRL-SHIFT-RIGHT` or by clicking and dragging a Tab. - Activate the Previous / Next Tab with `CTRL-PGUP` / `CTRL-PGDN` or by clicking a Tab. - Activate the first through eighth Tabs with `CTRL-1` thru `CTRL-8`. - Switch to the last Tab with `CTRL-9`. - Double-click a Tab to rename it. - Right-clicking on a Tab reveals more options you can explore within the [Command Palette](/terminal/command-palette/) or [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/#fundamentals). Tip **Terminal Tip** Using your `.zshrc` or `.bashrc` files on macOS or Linux, you can set a new Tab name: ``` # Set name, where MyTabName would be whatever you want to see in the Tab ( either a fixed string, $PWD, or something else )function set_name () { export WARP_DISABLE_AUTO_TITLE=true echo -ne "\033]0;MyTabName\007"}# Add the function to the environment variable in either Zsh or Bashif [ -n "$ZSH_VERSION" ]; then preexec_functions+=(set_name)elif [ -n "$BASH_VERSION" ]; then PROMPT_COMMAND='set_name'fi ``` Learn more about [setting shell tab titles in Windows Terminal](https://learn.microsoft.com/en-us/windows/terminal/tutorials/tab-title#set-the-shells-title). ### Tab Restoration Tab Restoration enables you to reopen recently closed tabs for up to 60 seconds. Configure this feature in **Settings** > **Features** > **Session** > **Enable reopening of closed sessions**. ### CTRL-TAB behavior `CTRL-TAB` shortcut defaults to activate the previous / next Tab. You can configure the shortcut to cycle the most recent session, including any [Split Panes](/terminal/windows/split-panes/), in **Settings** > **Features** > **Keys** > **Ctrl-Tab behavior**. ### Tabs behavior Please see our [Appearance > Tabs Behavior](/terminal/appearance/tabs-behavior/) docs for more Tab related settings. ### How Tabs work ## Tab groups Organize related tabs into named, collapsible groups. A tab group keeps its member tabs together in the tab bar, can be given a name and a color, and can be collapsed to hide its members until you need them. Tab groups work in both the horizontal tab bar and the [vertical tabs](/terminal/windows/vertical-tabs/) panel. ### Create a group - Right-click a tab and choose **New group with tab** to start a group from that tab. - Select multiple tabs first (see [Select multiple tabs](#select-multiple-tabs)), then right-click the selection to group them together. - Click the **+** new-tab button and choose **New tab group** to create a new group with a new tab. ### Select multiple tabs - `Cmd`\-click (macOS) or `Ctrl`\-click (Windows/Linux) a tab to add it to or remove it from the selection. - `Shift`\-click a tab to select every tab between it and the active tab. With multiple tabs selected, right-click to group them, move them into an existing group, or remove them from their group in one step. Note The active tab is always included in a selection. ### Manage a group Right-click a group's header to: - **Rename** the group. - Set a **color** for the group. - Add a **New tab in group**. - **Ungroup tabs** to dissolve the group while keeping its tabs. - Close the tabs in the group. Right-click an individual tab for **New group with tab**, **Move to group** (to move it into another group), and **Remove from group**. ### Collapse a group Click a group's header to collapse or expand it. Collapsed groups hide their member tabs to save space in the tab bar; click the header again to expand. Note 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**. ## 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: - **Detach a tab into its own window** — drag a tab out of the tab bar and drop it in empty space to open it in a new window. - **Move a tab between windows** — drag a tab onto another window's tab bar to move it there. The tab keeps its running session, panes, and state as it moves. This works from both the horizontal tab bar and the [vertical tabs](/terminal/windows/vertical-tabs/) panel. Note Dragging tabs between windows is available on macOS and Windows.