# LibTmux::Server::rename_window

- **Module:** LibTmux
- **Package:** LibTmux
- **Language:** Perl
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/core/lib/LibTmux/Server.pm#L1014
- **Page:** https://libtmux.org/en/perl/latest/reference/libtmux-server-rename_window/

```
sub rename_window($self, %args)
```

`rename_window(window => Window|window_id, name => string)`.

Rename the physical [`LibTmux::Window`](/en/perl/latest/reference/libtmux-window/) across all its links. Names remain literal rather than expanding tmux formats. Captured handles keep their observed name.

Returns `undef` after command acceptance. Performs I/O; failures propagate through [`LibTmux::X`](/en/perl/latest/reference/libtmux-x/). Captured objects are not modified.


```perl
    $server->rename_window(window => $window, name => 'logs');
```

## Methods

## Parameters

- `args`

## tmux command

The tmux commands behind `rename_window`.

- [`display-message`](/en/tmux/latest/manual/display-message/) (daemon identity or target preflight)
- [`rename-window`](/en/tmux/latest/manual/rename-window/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_display_message_entry`](/en/tmux/latest/reference/c-variable-cmd_display_message_entry/) (attribute)
- [`cmd_display_message_exec`](/en/tmux/latest/reference/c-function-cmd-display-message-c-cmd_display_message_exec/) (function)
- [`cmd_rename_window_entry`](/en/tmux/latest/reference/c-variable-cmd_rename_window_entry/) (attribute)
- [`cmd_rename_window_exec`](/en/tmux/latest/reference/c-function-cmd-rename-window-c-cmd_rename_window_exec/) (function)

## In other ports

Rename a window

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Window.rename_window`](/en/py/latest/reference/libtmux-window-rename_window/) (method) |
| Ruby | [`LibTmux::Window#rename`](/en/ruby/latest/reference/libtmux-window-rename/) (method) |
| Lua | [`libtmux.Window:rename`](/en/lua/latest/reference/libtmux-window-rename/) (method) |
| Erlang | [`tmux_window:rename/2`](/en/erlang/latest/reference/tmux_window-rename-2/) (function) |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | [`window.Window.rename`](/en/ts/latest/reference/window-window-rename/) (method) |
| Rust | [`window.Window.rename`](/en/rs/latest/reference/window-window-rename/) (method) |
| Go | [`tmux.Window.Rename`](/en/go/latest/reference/tmux-window-rename/) (method) |
| Java | [`io.github.libtmux.Window.rename`](/en/java/latest/reference/io-github-libtmux-window-window-rename/) (method) |
| C# | [`LibTmux.Window.RenameAsync`](/en/csharp/latest/reference/libtmux-window-renameasync/) (method) |
| C++ | [`libtmux::Window::rename`](/en/cxx/latest/reference/libtmux-window-rename/) (method) |
| Swift | [`Server.rename(_:to:)`](/en/swift/latest/reference/server-rename(_-to-)/) (method) |
| OCaml | [`Libtmux_unix.Client.rename_window`](/en/ocaml/latest/reference/libtmux_unix-client-rename_window/) (function) |

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