# libtmux.Pane.join

- **Module:** libtmux.Pane
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/9fdd083a8181a827889337b63cd4e6daea661a8c/src/libtmux/pane.py#L2370
- **Page:** https://libtmux.org/en/py/latest/reference/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)
```