# tmux.GlobalSessionScope.SetUpdateEnvironment

- **Module:** tmux.GlobalSessionScope
- **Package:** github.com/libtmux/libtmux-go/tmux
- **Language:** Go
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-go/blob/5f808882015a975a65acc7f9da5b3ff0d5cbdc91/tmux/option_generated.go#L7148
- **Page:** https://libtmux.org/reference/go/tmux-globalsessionscope-setupdateenvironment/

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

SetUpdateEnvironment replaces the complete "update-environment" session option array with SparseArray[string], preserving holes and empty values (tmux 3.2a or later). Read it with [SessionOptionValues.UpdateEnvironment] 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.
