# LibTmux.Pane.split!/3

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Elixir
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-elixir/blob/66b9b1c3f3f3186428abdfda2c76f5cf87446710/lib/libtmux/entities.ex#L308
- **Page:** https://libtmux.org/en/elixir/latest/reference/libtmux-pane-split-bang-3/

```
split!(connection, ref, options \\ [])
@spec split!(LibTmux.Action.connection(), LibTmux.Ref.t(), [
        split_option()
      ]) :: split_value()
```

Returns the created pane value when `split/3` completes; raises API errors or `LibTmux.Action.CompletionError` otherwise.

## Parameters

- `connection` (`LibTmux.Action.connection()`)
- `ref` (`LibTmux.Ref.t()`)
- `options` (`[split_option()]`)