# LibTmux.Server.renameSession

- **Package:** libtmux-haskell
- **Language:** Haskell
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-haskell/blob/663e212622a02aa74a9bdc8ff71e2b45fcb1d4d5/src/LibTmux/Server.hs#L195
- **Page:** https://libtmux.org/en/haskell/latest/reference/libtmux-server-v-renamesession/

```haskell
renameSession :: Server -> SessionRef -> Text -> IO ()
```

Signature types: [`Server`](/en/haskell/latest/reference/libtmux-server-t-server/), [`SessionRef`](/en/haskell/latest/reference/libtmux-snapshot-t-sessionref/), [`Text`](https://hackage.haskell.org/package/text-2.1.3/docs/Data-Text.html#t:Text), [`IO`](https://hackage.haskell.org/package/base-4.22.0.0/docs/Prelude.html#t:IO).

Rename the session targeted by a reference from this Server generation.
 The name is literal text. Earlier [`Snapshot`](/en/haskell/latest/reference/libtmux-snapshot-t-snapshot/) values keep their old names;
 call [`capture`](/en/haskell/latest/reference/libtmux-server-v-capture/) for a new observation. Use [`renameSessionWith`](/en/haskell/latest/reference/libtmux-server-v-renamesessionwith/) for a deadline.

## Referenced declarations

- [`LibTmux.Server.Server`](/en/haskell/latest/reference/libtmux-server-t-server/) (data type)
- [`LibTmux.Snapshot.SessionRef`](/en/haskell/latest/reference/libtmux-snapshot-t-sessionref/) (data type)

## tmux command

The tmux commands behind `renameSession`.

- [`rename-session`](/en/tmux/latest/manual/rename-session/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_rename_session_entry`](/en/tmux/latest/reference/c-variable-cmd_rename_session_entry/) (attribute)
- [`cmd_rename_session_exec`](/en/tmux/latest/reference/c-function-cmd-rename-session-c-cmd_rename_session_exec/) (function)

## Guides

Pages that discuss `renameSession`.

- [Rename and set pane titles](/en/haskell/latest/guides/mutations/)