# status-left

Source: https://libtmux.org/en/tmux/3.2a/catalog/options/status-left/

> Display string (by default the session name) to the left of the status line.

option tmux3.2a

Display string (by default the session name) to the left of the status line.

* Scope

  session

* Type

  Text

* Default

  `[#{session_name}]`

* Set

  [`set-option`](https://libtmux.org/en/tmux/3.2a/manual/set-option/) `status-left value`

* Read

  [`show-options`](https://libtmux.org/en/tmux/3.2a/manual/show-options/) `status-left`

## Description[#](https://libtmux.org/en/tmux/3.2a/catalog/options/status-left/#description)

Display `string` (by default the session name) to the left of the status line. `string` will be passed through [strftime(3)](). Also see the [FORMATS](https://libtmux.org/en/tmux/3.2a/manual/full/#FORMATS) and [STYLES](https://libtmux.org/en/tmux/3.2a/manual/full/#STYLES) sections.

For details on how the names and titles can be set see the [NAMES AND TITLES](https://libtmux.org/en/tmux/3.2a/manual/full/#NAMES_AND_TITLES) section.

Examples are:

```tmux-config
#(sysctl vm.loadavg)
#[fg=yellow,bold]#(apm -l)%%#[default] [#S]
```

The default is ‘`[#S] `’.

## Releases[#](https://libtmux.org/en/tmux/3.2a/catalog/options/status-left/#releases)

* [tmux 3.7c](https://libtmux.org/en/tmux/3.7c/catalog/options/status-left/) : present
* [tmux 3.2a](https://libtmux.org/en/tmux/3.2a/catalog/options/status-left/) : present

## Source[#](https://libtmux.org/en/tmux/3.2a/catalog/options/status-left/#source)

* Defined in

  [`options-table.c:638`](https://github.com/tmux/tmux/blob/3b929f332aafa7f1080eacc31feb11ffbb1d1841/options-table.c#L638)

* C source reference

  [`options_table`](https://libtmux.org/en/tmux/3.2a/reference/c-variable-options_table/)

* CLI Manual

  [Original manual entry](https://libtmux.org/en/tmux/3.2a/manual/full/#options-status-left)

## Used by[#](https://libtmux.org/en/tmux/3.2a/catalog/options/status-left/#used-by)

Library documentation that names this option.

* Rust

  [`options.generated.STATUS_LEFT`](https://libtmux.org/en/rs/latest/reference/options-generated-status_left/), [`server.Server.format`](https://libtmux.org/en/rs/latest/reference/server-server-format/)

* Go

  [`tmux.GlobalSessionScope.SetStatusLeft`](https://libtmux.org/en/go/latest/reference/tmux-globalsessionscope-setstatusleft/), [`tmux.Session.SetStatusLeft`](https://libtmux.org/en/go/latest/reference/tmux-session-setstatusleft/), [`tmux.SessionOptionValues.StatusLeft`](https://libtmux.org/en/go/latest/reference/tmux-sessionoptionvalues-statusleft/)

* Java

  [`io.github.libtmux.Options.setExpanded`](https://libtmux.org/en/java/latest/reference/io-github-libtmux-options-options-setexpanded/)