# Window layouts

Source: https://libtmux.org/en/ts/latest/workspace/configuration/layouts/

> Arrange panes with tmux layout names or a saved layout.

**Workspace Manager concept example** A working example of the core library. It can change without notice.



Choose a layout for each window. `even-horizontal` gives panes equal widths:

```yaml title="layouts.yaml"
session_name: layouts-example
windows:
  - window_name: work
    layout: even-horizontal
    panes: [null, null, null]
```

Other common tmux names include `even-vertical`, `main-horizontal`,
`main-vertical` and `tiled`. Full names avoid version-dependent abbreviation
ambiguity. Available names follow the selected tmux daemon.

## Saved layouts and terminal size

A captured layout describes pane geometry. Loading validates its syntax and
pane capacity, then tmux applies it to the actual window size. Resizing can
change the final dimensions. Use a named layout when exact saved geometry is
unnecessary.

Set window and pane `focus` explicitly when the active target matters. Layout
arrangement and active-pane selection are different settings.

[Capture](https://libtmux.org/en/ts/latest/workspace/cli/freeze/) can save a running layout; inspect it before
[reloading](https://libtmux.org/en/ts/latest/workspace/guides/export-session/) on a smaller terminal.

[CLI source](https://github.com/libtmux/libtmux-ts/blob/f36d692552bb9a373b45338bb5fece854e57cc3d/packages/workspace-cli/README.md).