Whetstone.
PanesFloating and stacked panes
Module 2 · Lesson 312 min

Floating and stacked panes

Two special pane arrangements. Floating panes hover above the tiled layout like a heads-up window; you toggle the whole floating layer in and out without disturbing the panes underneath. Stacked panes collapse several panes into one slot, showing one at a time with the others tucked into a stack you page through.

Floating is perfect for a throwaway shell, a quick git status, or a scratch pane you summon and dismiss. The floating layer sits on top and remembers its contents while hidden. You can embed a floating pane down into the tiled layout, or pin it so it stays visible even when you toggle the layer off.

Floating panes
AltthenfToggle the floating layer (from Normal)
CtrlthenpEnter Pane mode
wToggle floating panes visibility
eEmbed a floating pane into the tiled layout (or float a tiled one)
iToggle pinned state of a floating pane

Stacked panes are the space-saver. Instead of shrinking three panes to fit, Zellij can stack them so only the focused one is expanded and the rest are collapsed to a single line each. You create one with s in Pane mode; moving focus into a collapsed member expands it and collapses the previous.

Stacked panes
CtrlthenpEnter Pane mode
sNew pane, stacked on the current one
Practice

Try it yourself

Do

Summon and dismiss a floating pane

Get a feel for the floating layer.

  • From Normal, press Alt f to open a floating pane
  • Run something in it, like git status or ls
  • Press Alt f again to hide the floating layer; the tiled panes are untouched
  • Press Alt f once more; your floating pane and its output are still there
Done whenThe floating pane hid and reappeared with its contents intact, and your tiled layout never moved.
Do

Embed a floating pane

Push a float down into the tiled layout.

  • Open a floating pane with Alt f
  • Press Ctrl p then e
  • The pane becomes a normal tiled pane in the layout
Done whenThe floating pane joined the tiled layout as a regular pane.
Do

Build a stack

Create stacked panes and page through them.

  • In Pane mode, press s to add a stacked pane
  • Do it once or twice more to build a stack
  • Move focus up and down the stack with Alt k and Alt j; watch each member expand as it gains focus
Done whenYou have a stack where only the focused pane is expanded and moving focus expands the next one.
Sign in to track your progress →