# tmux.GlobalSessionScope.SetStatusFormat

- **Module:** tmux.GlobalSessionScope
- **Package:** github.com/libtmux/libtmux-go/tmux
- **Language:** Go
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-go/blob/52968a3181c1c9e6d1b26c565d4b170968ae61c0/tmux/option_generated.go#L7179
- **Page:** https://libtmux.org/en/go/latest/reference/tmux-globalsessionscope-setstatusformat/

```
tmux.GlobalSessionScope.SetStatusFormat(ctx: context.Context, value: SparseArray[string]) -> (SetArrayResult, error)
```

SetStatusFormat replaces the complete "status-format" session option array with SparseArray[string], preserving holes and empty values (tmux 3.2a or later). Read it with [SessionOptionValues.StatusFormat] from [GlobalSessionScope.Options]; [GlobalSessionScope.UnsetOption] restores inheritance or the global default. Replacement is not atomic: the result reports confirmed writes, and failures stop without rollback. Serialize concurrent replacement of the same target and option.