Warp documentation
  • πŸš€Getting Started
    • Quickstart Guide
    • What is Warp?
    • Migrate to Warp
    • Using Warp with [zsh|bash|fish|pwsh]
    • Privacy
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
    • Changelog
  • 🎨Appearance
    • Themes
    • Custom Themes
    • Prompt
    • Input Position
    • Text, Fonts, & Cursor
    • Size, Opacity, & Blurring
    • Pane Dimming & Focus
    • Blocks Behavior
    • Tabs Behavior
    • App Icons
  • πŸ“•Features
    • Warp AI
      • Active AI
      • Agent Mode
      • Generate
      • Model Context Protocol
      • Voice
      • Rules
    • Command Palette
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Teams
    • Session Sharing
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • 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
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
    • Accessibility
    • Find
    • Files, Links, & Scripts
    • Markdown Viewer
    • Working Directory
    • Smart-Select
    • Full-screen Apps
    • Keyboard Shortcuts
    • Notifications & Audible Bell
    • Settings Sync (Beta)
    • Quit Warning
    • Integrations
    • URI Scheme
    • Network Log
    • Secret Redaction
    • Linux
  • πŸ“ŠHow Does Warp Compare?
    • Performance
    • Terminal features
  • ❓Help
    • Sending Feedback & Logs
    • Plans, Subscriptions & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • The Basics
  • Create A Block
  • Select a Single Block
  • Select Multiple Blocks
  • Navigate Blocks

Was this helpful?

  1. Features
  2. Blocks

Block Basics

The basics of creating, selecting, and navigating between Blocks.

PreviousBlocksNextBlock Actions

Last updated 2 months ago

Was this helpful?

The Basics

  • Blocks group your command and command output

  • The Input Editor can pin to the bottom, pin to the top, or start at the top.

  • Blocks grow from the bottom to the top.

  • Blocks are color-coded. Blocks that quit with a non-zero exit code have a red background and red sidebar.

Try it yourself! Type xyz (or some other command that doesn’t exist) and hit ENTER

Create A Block

  1. Execute a command (type ls and hit ENTER) in the Input Editor at the bottom of the screen.

  2. Your command and output are grouped into a Block.

  3. Try executing a different command (type echo hello and hit ENTER).

  4. Warp adds your newly created Block to the bottom (directly above the input editor).

Select a Single Block

  • Using your mouse: click on a Block.

  • Or using your keyboard: hit CMD-UP (or CMD-DOWN if input as pinned up top) to select the most recently executed Block and use the UP ↑ and DOWN ↓ arrow keys to navigate to the desired Block.

  • For long Blocks:

    • You can click "Jump to the bottom of this block".

    • You can press SHIFT-CMD-UP/SHIFT-CMD-DOWN to Scroll to the top/bottom of the selected block.

  • Using your mouse: Click on a Block.

  • Or using your keyboard: hit CTRL-UP (or CTRL-DOWN if input as pinned up top) to select the most recently executed Block and use the UP ↑ and DOWN ↓ arrow keys to navigate to the desired Block.

  • For long Blocks:

    • You can click "Jump to the bottom of this block".

    • You can press CTRL-SHIFT-UP/CTRL-SHIFT-DOWN to Scroll to the top/bottom of the selected block.

  • Using your mouse: Click on a Block.

  • Or using your keyboard: hit CTRL-UP (or CTRL-DOWN if input as pinned up top) to select the most recently executed Block and use the UP ↑ and DOWN ↓ arrow keys to navigate to the desired Block.

  • For long Blocks:

    • You can click "Jump to the bottom of this block".

    • You can press CTRL-SHIFT-UP/CTRL-SHIFT-DOWN to Scroll to the top/bottom of the selected block.

Select Multiple Blocks

  • Click another Block while holding CMD to toggle the selection of that Block, or

  • Click another Block while holding SHIFT to select a range of Block, or

  • Use SHIFT-UP ↑ or SHIFT-DOWN ↓ to expand the active selection (the Block with the thicker border) up or down, respectively.

  • Click another Block while holding CTRL-SHIFT to toggle the selection of that Block, or

  • Click another Block while holding SHIFT to select a range of Block, or

  • Use SHIFT-UP ↑ or SHIFT-DOWN ↓ to expand the active selection (the Block with the thicker border) up or down, respectively.

  • Click another Block while holding CTRL-SHIFT to toggle the selection of that Block, or

  • Click another Block while holding SHIFT to select a range of Block, or

  • Use SHIFT-UP ↑ or SHIFT-DOWN ↓ to expand the active selection (the Block with the thicker border) up or down, respectively.

Navigate Blocks

  • Either scroll using your mouse or the scrollbar or select a Block and use the UP ↑ and DOWN ↓ arrow keys.

From the , you can also "Scroll to the top/bottom of selected block".

From the , you can also "Scroll to the top/bottom of selected block".

From the , you can also "Scroll to the top/bottom of selected block".

"Scroll Terminal output up/down one line" is also a way to navigate block output, and can be configured with a keyboard shortcut or accessed from the .

When the output of a command is cut off, Warp keeps the pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block.

πŸ“•
Command Palette
Command Palette
Command Palette
Command Palette
Sticky Command Header
Create a Block
Select a Single Block
Select Multiple Blocks
Navigate between Blocks