# status-format

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

> Specify the format to be used for each line of the status line.

option tmux3.2a

Specify the format to be used for each line of the status line.

* Scope

  session

* Type

  Text, array of values

* Default

  Show the default

  ```
  #[align=left range=left #{status-left-style}]#[push-default]#{T;=/#{status-left-length}:status-left}#[pop-default]#[norange default]#[list=on align=#{status-justify}]#[list=left-marker]<#[list=right-marker]>#[list=on]#{W:#[range=window|#{window_index} #{window-status-style}#{?#{&&:#{window_last_flag},#{!=:#{window-status-last-style},default}}, #{window-status-last-style},}#{?#{&&:#{window_bell_flag},#{!=:#{window-status-bell-style},default}}, #{window-status-bell-style},#{?#{&&:#{||:#{window_activity_flag},#{window_silence_flag}},#{!=:#{window-status-activity-style},default}}, #{window-status-activity-style},}}]#[push-default]#{T:window-status-format}#[pop-default]#[norange default]#{?window_end_flag,,#{window-status-separator}},#[range=window|#{window_index} list=focus #{?#{!=:#{window-status-current-style},default},#{window-status-current-style},#{window-status-style}}#{?#{&&:#{window_last_flag},#{!=:#{window-status-last-style},default}}, #{window-status-last-style},}#{?#{&&:#{window_bell_flag},#{!=:#{window-status-bell-style},default}}, #{window-status-bell-style},#{?#{&&:#{||:#{window_activity_flag},#{window_silence_flag}},#{!=:#{window-status-activity-style},default}}, #{window-status-activity-style},}}]#[push-default]#{T:window-status-current-format}#[pop-default]#[norange list=on default]#{?window_end_flag,,#{window-status-separator}}}#[nolist align=right range=right #{status-right-style}]#[push-default]#{T;=/#{status-right-length}:status-right}#[pop-default]#[norange default],#[align=centre]#{P:#{?pane_active,#[reverse],}#{pane_index}[#{pane_width}x#{pane_height}]#[default] }
  ```

* Set

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

* Read

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

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

Specify the format to be used for each line of the status line. The default builds the top status line from the various individual status options below.

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

* [tmux 3.7c](https://libtmux.org/en/tmux/3.7c/catalog/options/status-format/) : default a longer list to a longer list
* [tmux 3.2a](https://libtmux.org/en/tmux/3.2a/catalog/options/status-format/) : present

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

* Defined in

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

* 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-format)

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

Library documentation that names this option.

* Rust

  [`options.generated.STATUS_FORMAT`](https://libtmux.org/en/rs/latest/reference/options-generated-status_format/)

* Go

  [`tmux.GlobalSessionScope.SetStatusFormat`](https://libtmux.org/en/go/latest/reference/tmux-globalsessionscope-setstatusformat/), [`tmux.Session.SetStatusFormat`](https://libtmux.org/en/go/latest/reference/tmux-session-setstatusformat/), [`tmux.SessionOptionValues.StatusFormat`](https://libtmux.org/en/go/latest/reference/tmux-sessionoptionvalues-statusformat/)