Skip to content

DECSTBM constrains scrolling

Category: scrollback · Baseline: core · Tags: DEC Private Modes, VT100 · Specification ↗

When a scroll region is set via DECSTBM, scrolling (line feeds, index, SU/SD) should be constrained to the defined region. Lines outside the scroll region must remain fixed. This is the fundamental mechanism that enables fixed headers, footers, and split-screen layouts in TUI applications. Without proper scroll region isolation, tmux panes, vim status bars, and editor chrome would be disrupted by scrolling content.
How this is testedautomated
Write "FIXED_TOP" on row 0, set DECSTBM 3;10, move inside region, write enough lines to trigger scrolling, verify row 0 still contains "FIXED_TOP".

The same probe runs against headless backends (via Termless) and real terminal apps (via a daemon launched in each terminal). This lets us distinguish parser correctness from rendering correctness.

Analysis2026-04-06

Supported by all 12 tested terminals — universal adoption. Part of the Core TUI baseline.

Supported by 14 of 14 backends (100%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✓ yes
Ghostty1.3.1✓ yes
VS Code✓ yes
Warp✓ yes
Cursor✓ yes
Terminal.app✓ yes

Headless Backends

Parser correctness only — a means the parser accepts the sequence.

BackendVersionSupportNotes
Alacritty0.26.0✓ yes
Kitty0.40.0✓ yes
vt100.js0.2.1✓ yes
vterm0.2.0✓ yes
WezTerm0.1.0-fork.5✓ yes
xterm.js5.5.0✓ yes