Skip to content

Bracketed paste (DECSET 2004)

Category: modes · Baseline: modern · Tags: DEC Private Modes, Xterm Extensions · Specification ↗

ESC [ ? 2004 h
Bracketed paste mode wraps pasted text in special escape sequences so applications can distinguish pasted content from typed input. Enable with ESC [ ? 2004 h. When active, pasted text is bracketed between ESC [ 200 ~ (start) and ESC [ 201 ~ (end). This is a security feature: without bracketed paste, pasting text containing newlines into a shell prompt would immediately execute commands. With bracketed paste, the shell can treat the entire paste as literal text. This also enables editors to handle paste correctly — vim can enter paste mode automatically, preserving indentation rather than auto-indenting each line. Widely adopted. Most modern shells (bash, zsh, fish) and editors (vim, emacs) enable bracketed paste by default.
How this is testedautomated
Send \x1b[?2004h (DECSET 2004), verify bracketedPaste mode is active.

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 11 of 12 terminals (92%). Not supported by: vt100.js. Part of the Modern TUI baseline. Notes: vt100.js: Not in VT100/VT220xterm extension.

Supported by 13 of 14 backends (93%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✓ yesDECRPM: mode reset
Ghostty1.3.1✓ yesDECRPM: mode reset
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
vterm0.2.0✓ yes
WezTerm0.1.0-fork.5✓ yes
xterm.js5.5.0✓ yes
vt100.js0.2.1✗ noNot in VT100/VT220 — xterm extension