# libtmux::Session::show_message

- **Module:** libtmux::Session
- **Package:** libtmux-cxx
- **Language:** C++
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-cxx/blob/393d4b0ad666f18a6581f1eb281741a75a7503f0/include/libtmux/entities.hpp#L474
- **Page:** https://libtmux.org/en/cxx/latest/reference/libtmux-session-show_message/

```
libtmux::Session::show_message(text: std::string_view) -> expected< void, CommandFailure >
```

Put a message on the status line of every client attached here, and send it to a control client as `message`.

tmux expands the text as a format, so a `#{...}` in it is substituted rather than shown. Text built from data belongs in `escape_literal` first.
