# libtmux.Pane.join

- **Module:** libtmux.Pane
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/036c521c4b83ce6e434eb50afe2a0d08a6a05e46/src/libtmux/pane.py#L2370
- **Page:** https://libtmux.org/reference/py/libtmux-pane-join/

```
libtmux.Pane.join(self, target: str | Pane | Window, vertical: bool = True, detach: bool = True, full_window: bool | None = None, size: str | int | None = None, before: bool | None = None) -> None
```

Join this pane into another window/pane via ``$ tmux join-pane``.

This is the inverse of :meth:`break_pane`.

## Parameters

- `self`
- `target` (str | Pane | Window) — Target pane or window to join into.
- `vertical` (bool) — Join vertically (``-v`` flag), default True. Set to False for
horizontal (``-h``).
- `detach` (bool) — Do not switch to the target window (``-d`` flag), default True.
- `full_window` (bool | None) — Join spanning the full window width/height (``-f`` flag).
- `size` (str | int | None) — Size for the joined pane (``-l`` flag).
- `before` (bool | None) — Place the pane before the target (``-b`` flag).

## Example

```python
>>> pane_to_join = window.split(shell='sleep 1m')
>>> new_window = pane_to_join.break_pane()
>>> pane_to_join.join(window)
```