Warp documentation
  • Getting Started
    • Quickstart Guide
    • What is Warp?
    • Supported shells
    • Migrate to Warp
    • Keyboard Shortcuts
    • Changelog
  • Agents
    • Warp AI
      • Agent Mode
  • Active AI
  • Generate
  • Voice
  • Terminal
    • Appearance
      • Themes
      • Custom Themes
      • Prompt
      • Input Position
      • Text, Fonts, & Cursor
      • Size, Opacity, & Blurring
      • Pane Dimming & Focus
      • Blocks Behavior
      • Tabs Behavior
      • App Icons
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Find
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Command Palette
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
    • More Features
      • Accessibility
      • Files, Links, & Scripts
      • Markdown Viewer
      • Working Directory
      • Smart-Select
      • Full-screen Apps
      • Notifications & Audible Bell
      • Settings Sync (Beta)
      • Quit Warning
      • URI Scheme
      • Linux
    • Comparisons
      • Performance
      • Terminal features
  • Integrations
  • Knowledge & Collaboration
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Model Context Protocol
    • Rules
    • Teams
    • Session Sharing
  • Privacy
    • Privacy
    • Secret Redaction
    • Network Log
  • Community
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
  • Support & Billing
    • Sending Feedback & Logs
    • Plans & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • How to use Tabs
  • Tab Restoration
  • CTRL-TAB Behavior
  • Tabs Behavior
  • How Tabs work

Was this helpful?

  1. Terminal
  2. Window Management

Tabs

The Tabs feature allows you to organize a window into multiple terminal sessions. Tabs can be customized with a title and/or an ANSI color to help identify them.

PreviousGlobal HotkeyNextSplit Panes

Last updated 2 months ago

Was this helpful?

New Tabs will default to the active Tabs’ current and the actual color values will be automatically derived from your Warp .

How to use Tabs

  • Right-click on the new Tab button + to make a new tab, restore closed tab, or run a saved .

  • 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 or .

  • Right-click on the new Tab button + to make a new tab, restore closed tab, or run a saved .

  • 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 or .

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

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 () {
  echo -ne "\033]0;MyTabName\007"
}
# Add the function to the environment variable in either Zsh or Bash
if [ -n "$ZSH_VERSION" ]; then
  precmd_functions+=(set_name)
elif [ -n "$BASH_VERSION" ]; then
  PROMPT_COMMAND='set_name'
fi

Learn more about Tab names .

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

Tabs Behavior

How Tabs work

Right-click on the new Tab button + to make a new tab, restore closed tab, or run a saved .

Right-clicking on a Tab reveals more options you can explore within the or .

CTRL-TAB shortcut defaults to activate the previous / next Tab. You can configure the shortcut to cycle the most recent session, including any , in Settings > Features > Keys > Ctrl-Tab behavior

Please see our docs for more Tab related settings.

Launch Configuration
Split Panes
Appearance > Tabs Behavior
Working Directory
Theme
Launch Configuration
Command Palette
Launch Configuration
Command Palette
here
Command Palette
Keyboard Shortcuts
Keyboard Shortcuts
Keyboard Shortcuts
Tabs Demo