# libtmux:move-pane

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/placement.lisp#L97
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-move-pane/

```
(move-pane client source destination &key (direction :vertical) size percent before full-size (detached t) (observe t) cancel-token timeout output-limit)
```

Move SOURCE pane beside DESTINATION; return an outcome with the moved pane.
DIRECTION is :HORIZONTAL or :VERTICAL. SIZE is cells; PERCENT is 1..100,
mutually exclusive with SIZE. BEFORE changes placement and FULL-SIZE spans the
window. Percent sizing retains tmux's version semantics: with FULL-SIZE, 3.3a
uses destination-pane dimensions and 3.8 uses whole-window dimensions. Use SIZE
for cell-based control. DETACHED defaults true.
An emptied source window is destroyed, including all its links. With DETACHED
false, tmux chooses the session context of the physical destination. OBSERVE
supplies a replacement source pane; its old observation retains its old window.
Signals STALE-TARGET or an operational condition.

## Parameters

- `client`
- `source`
- `destination`
- `direction?`
- `size?`
- `percent?`
- `before?`
- `full-size?`
- `detached?`
- `observe?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## tmux command

The tmux commands behind `move-pane`.

- [`move-pane`](/en/tmux/latest/manual/move-pane/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_move_pane_entry`](/en/tmux/latest/reference/c-variable-cmd_move_pane_entry/) (attribute)
- [`cmd_join_pane_exec`](/en/tmux/latest/reference/c-function-cmd-join-pane-c-cmd_join_pane_exec/) (function)

## Guides

Pages that discuss `move-pane`.

- [Explicit operations](/en/lisp/latest/guides/operations/)