Skip to main content

Raise/lower

AI-Generated Content
This page was generated with the assistance of AI and may contain inaccuracies. It is intended as a placeholder for future human verification. If you spot issues ahead of its initial review, please report them on GitHub!
Experimental

Raise and Lower are XTerm window manipulation sequences that change the terminal window's position in the window stacking order.

Syntax​

CSI 5 t     Raise window to front of stack
CSI 6 t Lower window to back of stack
Formal syntax
raise_window = 0x1b, "[", "5", "t" ;
lower_window = 0x1b, "[", "6", "t" ;

Description​

These sequences control the stacking order (z-order) of the terminal window relative to other windows on the desktop. They are part of the XTerm CSI Ps ; Ps ; Ps t window manipulation family.

  • CSI 5 t — Raises the terminal window to the front of the window stack. The window becomes the topmost window, appearing above all other windows. This does not change the keyboard focus.
  • CSI 6 t — Lowers the terminal window to the back of the window stack. The window is sent behind all other windows on the desktop.

Unlike Iconify, these sequences do not minimize or restore the window. They only change the stacking order while keeping the window at its current size and position.

On systems with tiling window managers or compositing environments, the behavior of these sequences may differ from traditional stacking window managers.

note

Some terminal emulators disable these sequences by default for security reasons, as a malicious application could obscure the user's terminal or bring it into focus unexpectedly. Check your terminal's configuration for options to enable or disable window manipulation sequences.

Examples​

# Raise window to front
printf '\e[5t'

# Lower window to back
printf '\e[6t'

Specifications​

SpecificationSection
XTerm ctlseqs—

Terminal support​

TerminalSupportVersionNotes
Terminal Emulators
Alacritty✗NoRejected per escape_support.md:81-82
Bobcat✓0.9.0Handled via WhenWindowGeometryChange callback; requires WindowActions enabled in profile
contour✗NoNot implemented in WINDOWMANIP handler
foot✗NoCSI 5/6 t logs unimplemented warning
Ghostty✗NoCSI 5/6 t not implemented
iTerm2✓v20260216-nightlyCSI 5 t and CSI 6 t
Kitty✗NoCSI 5/6 t not supported
Konsole✗NoCSI 5 t / 6 t not implemented
mintty✓YesCSI 5/6 t implemented
mlterm✗NoCSI 5/6 t not implemented
PuTTY✓0.75CSI 5/6 t supported (raise/lower) at terminal.c:4883-4894
Rio✗No
rxvt-unicode✓1.2
st✗NoNo CSI t window manipulation sequences implemented
terminology✗No
VT100✗No
VTE~YesParsed but implementation is stub - breaks without action
WezTerm✗NoParsed but handled as unimplemented
Windows Terminal✗NoCSI 5/6 t not in WindowManipulationType enum
xterm✓xterm-93
xterm.js✓4.4.0CSI 5/6 t. Requires windowOptions.raiseWin/lowerWin enabled.
Multiplexers
cy✗NoExplicitly ignored
GNU Screen✗NoCSI 5/6 t not implemented
tmux✗NoSequence parsed but ignored (case 5/6 in winops)
tuios✗NoCSI 5/6 t not handled
Zellij✗No

See also​