# status-format

Source: https://libtmux.org/en/tmux/3.7c/catalog/options/status-format/

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

option tmux3.7c

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 #{E: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} #{E:window-status-style}#{?#{&&:#{window_last_flag},#{!=:#{E:window-status-last-style},default}}, #{E:window-status-last-style},}#{?#{&&:#{window_bell_flag},#{!=:#{E:window-status-bell-style},default}}, #{E:window-status-bell-style},#{?#{&&:#{||:#{window_activity_flag},#{window_silence_flag}},#{!=:#{E:window-status-activity-style},default}}, #{E:window-status-activity-style},}}]#[push-default]#{T:window-status-format}#[pop-default]#[norange default]#{?loop_last_flag,,#{E:window-status-separator}},#[range=window|#{window_index} list=focus #{?#{!=:#{E:window-status-current-style},default},#{E:window-status-current-style},#{E:window-status-style}}#{?#{&&:#{window_last_flag},#{!=:#{E:window-status-last-style},default}}, #{E:window-status-last-style},}#{?#{&&:#{window_bell_flag},#{!=:#{E:window-status-bell-style},default}}, #{E:window-status-bell-style},#{?#{&&:#{||:#{window_activity_flag},#{window_silence_flag}},#{!=:#{E:window-status-activity-style},default}}, #{E:window-status-activity-style},}}]#[push-default]#{T:window-status-current-format}#[pop-default]#[norange list=on default]#{?loop_last_flag,,#{E:window-status-separator}}}#[nolist align=right range=right #{E:status-right-style}]#[push-default]#{T;=/#{status-right-length}:status-right}#[pop-default]#[norange default],#[align=left]#{R: ,#{n:#{session_name}}}P: #[norange default]#[list=on align=#{status-justify}]#[list=left-marker]<#[list=right-marker]>#[list=on]#{P:#[range=pane|#{pane_id} #{E:pane-status-style}]#[push-default]#{T:window-pane-status-format}#[pop-default]#[norange list=on default]  ,#[range=pane|#{pane_id} list=focus #{?#{!=:#{E:pane-status-current-style},default},#{E:pane-status-current-style},#{E:pane-status-style}}]#[push-default]#{T:window-pane-current-status-format}#[pop-default]#[norange list=on default] },#[align=left]#{R: ,#{n:#{session_name}}}S: #[norange default]#[list=on align=#{status-justify}]#[list=left-marker]<#[list=right-marker]>#[list=on]#{S:#[range=session|#{session_id} #{E:session-status-style}]#[push-default]#S#{session_alert}#[pop-default]#[norange list=on default]  ,#[range=session|#{session_id} list=focus #{?#{!=:#{E:session-status-current-style},default},#{E:session-status-current-style},#{E:session-status-style}}]#[push-default]#S*#{session_alert}#[pop-default]#[norange list=on default] }
  ```

* Set

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

* Read

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

## Description[#](https://libtmux.org/en/tmux/3.7c/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.7c/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.7c/catalog/options/status-format/#source)

* Defined in

  [`options-table.c:855`](https://github.com/tmux/tmux/blob/e476c1230b958df0cb12977517d24b3dc931375b/options-table.c#L855)

* C source reference

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

* CLI Manual

  [Original manual entry](https://libtmux.org/en/tmux/3.7c/manual/full/#options-status-format)

## Used by[#](https://libtmux.org/en/tmux/3.7c/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/)