# tmux_pane:move/3

- **Package:** libtmux_erlang
- **Language:** Erlang
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-erlang/blob/d1b6308440cf9eb8f6647e7ae434bce60e849368/apps/libtmux_erlang/src/tmux_pane.erl#L245
- **Page:** https://libtmux.org/en/erlang/latest/reference/tmux_pane-move-3/

```
move(Source, Destination, Options)
-spec move(tmux_model:pane(),
           tmux_model:pane(),
           join_options()) ->
              {ok, tmux_operation:completed()} |
              {error, map()}.
```

Rearrange a source pane beside the destination, including within one window. Uses native [move-pane](/en/tmux/latest/manual/move-pane/), whose placement and lifetime behavior follow `join/3`. Both calls use explicit physical IDs and leave captured rows unchanged.

## Parameters

- `Source` (`tmux_model:pane()`)
- `Destination` (`tmux_model:pane()`)
- `Options` (`join_options()`)

## tmux command

The tmux commands behind `move/3`.

- [`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/3`.

- [Native API documentation](/en/erlang/latest/guides/api-documentation/)
- [Isolate and rejoin a running pane](/en/erlang/latest/guides/panes/)

## In other ports

Move a pane to another position

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Pane.move`](/en/py/latest/reference/libtmux-pane-move/) (method) |
| Ruby | [`LibTmux::Pane#move`](/en/ruby/latest/reference/libtmux-pane-move/) (method) |
| Lua | [`libtmux.Pane:move_to`](/en/lua/latest/reference/libtmux-pane-move_to/) (method) |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | no equivalent on `Pane` |
| Rust | no equivalent on `Pane` |
| Go | [`tmux.Pane.Move`](/en/go/latest/reference/tmux-pane-move/) (method) |
| Java | no equivalent on `Pane` |
| C# | [`LibTmux.Pane.MoveAsync`](/en/csharp/latest/reference/libtmux-pane-moveasync/) (method) |
| C++ | no equivalent on `Pane` |
| Swift | `Server.move(_:to:at:)` moves a window, not a pane |
| OCaml | [`Libtmux_unix.Client.move_pane`](/en/ocaml/latest/reference/libtmux_unix-client-move_pane/) (function) |
| Perl | No dedicated equivalent in the selected Perl surface. Explicit Server::cmd remains available for native tmux commands. |

No equivalent is recorded in PowerShell, Julia, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.