# tmux_pane:resize/2

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

```
resize(Pane, Options)
-spec resize(tmux_model:pane(), resize_options()) ->
                {ok, tmux_operation:completed()} |
                {error, tmux_operation:failure()}.
```

Request an absolute width, height or both for this registered physical pane. Performs I/O after validating dimensions and origin. tmux can clamp the request to its layout constraints and can resize neighboring panes. Resizing a tiled pane unzooms its window. Use `get/2` for actual dimensions; the input row is unchanged. The accepted library range is not a promise that every server accepts every dimension: tmux versions can impose tighter limits and return a command error.

An empty request is rejected before dispatch:

## Examples

```erlang
1> tmux_pane:resize(invalid_row, #{}).
{error,#{code => empty_resize}}
```

## Parameters

- `Pane` (`tmux_model:pane()`)
- `Options` (`resize_options()`)

## tmux command

The tmux commands behind `resize/2`.

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

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_resize_pane_entry`](/en/tmux/latest/reference/c-variable-cmd_resize_pane_entry/) (attribute)
- [`cmd_resize_pane_exec`](/en/tmux/latest/reference/c-function-cmd-resize-pane-c-cmd_resize_pane_exec/) (function)

## Guides

Pages that discuss `resize/2`.

- [Build commands before running them](/en/erlang/latest/guides/commands/)

## In other ports

Resize a pane

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Pane.resize`](/en/py/latest/reference/libtmux-pane-resize/) (method) |
| Ruby | [`LibTmux::Pane#resize`](/en/ruby/latest/reference/libtmux-pane-resize/) (method) |
| Lua | [`libtmux.Pane:resize`](/en/lua/latest/reference/libtmux-pane-resize/) (method) |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | [`pane.Pane.resize`](/en/ts/latest/reference/pane-pane-resize/) (method) |
| Rust | [`pane.Pane.resize`](/en/rs/latest/reference/pane-pane-resize/) (method) |
| Go | [`tmux.Pane.Resize`](/en/go/latest/reference/tmux-pane-resize/) (method) |
| Java | [`io.github.libtmux.Pane.resize`](/en/java/latest/reference/io-github-libtmux-pane-pane-resize/) (method) |
| C# | [`LibTmux.Pane.ResizeAsync`](/en/csharp/latest/reference/libtmux-pane-resizeasync/) (method) |
| C++ | no direct equivalent; `libtmux::Window::resize` resizes the window, not a pane within it |
| Swift | [`Server.resize(_:width:height:)`](/en/swift/latest/reference/server-resize(_-width-height-)/) (method) |
| OCaml | [`Libtmux_unix.Client.resize_pane`](/en/ocaml/latest/reference/libtmux_unix-client-resize_pane/) (function) |
| Perl | [`LibTmux::Server::resize_pane`](/en/perl/latest/reference/libtmux-server-resize_pane/) (method). Explicit Server operation. Captured entities remain local observations; use a new snapshot to observe changes. |

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