Warp documentation
  • Getting Started
    • Quickstart Guide
    • What is Warp?
    • Supported Shells
    • Migrate to Warp
    • Keyboard Shortcuts
    • Changelog
  • Agents
    • Warp AI
    • Using Agents
      • Agent Conversations
      • Agent Context
      • Model Choice
    • Autonomy
      • Agent Permissions
      • Run to completion
    • Code
      • Codebase Context
      • Reviewing Agent Code
    • Active AI
    • Generate
    • Voice
    • AI FAQs
  • 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
      • SSH Legacy
    • 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
      • Warp Drive as Agent Mode Context
    • 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.

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

How to use Tabs

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

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

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

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

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

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

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

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, in Settings > Features > Keys > Ctrl-Tab behavior

Tabs Behavior

Please see our Appearance > Tabs Behavior docs for more Tab related settings.

How Tabs work

PreviousGlobal HotkeyNextSplit Panes

Last updated 21 days ago

Was this helpful?

Tabs Demo