# Terminal Block Basics

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

- 网址：https://funcoding.ai/agents/warp/terminal/blocks/block-basics/
- 来源：Warp 官方文档原文（英文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.warp.dev/terminal/blocks/block-basics/

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

<div class="callout callout-note">

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

</div>

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

**macOS**

* Using your mouse: click on a Block.
* Or using your keyboard: hit `⌘+↑` (or `⌘+↓` if input is pinned up top) to select the most recently executed Block and use the `↑` and `↓` 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+↑`/`⌘+Shift+↓` to scroll to the top/bottom of the selected block.
  * From the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block".

**Windows**

* Using your mouse: click on a Block.
* Or using your keyboard: hit `Ctrl+↑` (or `Ctrl+↓` if input is pinned up top) to select the most recently executed Block and use the `↑` and `↓` 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+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block.
  * From the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block".

**Linux**

* Using your mouse: click on a Block.
* Or using your keyboard: hit `Ctrl+↑` (or `Ctrl+↓` if input is pinned up top) to select the most recently executed Block and use the `↑` and `↓` 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+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block.
  * From the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block".

## Select multiple blocks

**macOS**

* Click another Block while holding `⌘` to toggle the selection of that Block, or
* Click another Block while holding `Shift` to select a range of Blocks, or
* Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively.

**Windows**

* 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 Blocks, or
* Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively.

**Linux**

* 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 Blocks, or
* Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively.

## Navigate blocks

**macOS**

* **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar.
* **Arrow keys** - Select a Block and use `↑` and `↓` to move between Blocks.
* **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page.
* **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output.
* **Scroll within a selected Block** - Press `⌘+Shift+↑` or `⌘+Shift+↓` to scroll to the top or bottom of the selected Block.
* **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/).
* When the output of a command is cut off, Warp keeps the [Sticky Command Header](https://funcoding.ai/agents/warp/terminal/blocks/sticky-command-header/) 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.

**Windows**

* **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar.
* **Arrow keys** - Select a Block and use `↑` and `↓` to move between Blocks.
* **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page.
* **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output.
* **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block.
* **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/).
* When the output of a command is cut off, Warp keeps the [Sticky Command Header](https://funcoding.ai/agents/warp/terminal/blocks/sticky-command-header/) 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.

**Linux**

* **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar.
* **Arrow keys** - Select a Block and use `↑` and `↓` to move between Blocks.
* **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page.
* **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output.
* **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block.
* **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/).
* When the output of a command is cut off, Warp keeps the [Sticky Command Header](https://funcoding.ai/agents/warp/terminal/blocks/sticky-command-header/) 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.

<div class="callout callout-note">

During long-running or full-screen commands, `Page Up`, `Page Down`, `Home`, and `End` are forwarded to the running program. See the full list of scrolling shortcuts on the [Keyboard Shortcuts](https://funcoding.ai/agents/warp/getting-started/keyboard-shortcuts/) page.

</div>