# types.FormatSubscription

- **Module:** types
- **Package:** @libtmux/libtmux
- **Language:** TypeScript
- **Kind:** interface
- **Source:** https://github.com/libtmux/libtmux-ts/blob/2cb93308200da38a26b59876618116850f110607/packages/libtmux/src/types.ts#L558
- **Page:** https://libtmux.org/reference/ts/types-formatsubscription/

A format tmux expands and reports whenever its value changes.

Reports arrive as {@link TmuxSubscriptionEvent}. tmux evaluates every
subscription at most once per second, so this reports a change rather than
every intermediate value.

## Example

```ts
{ format: "#{pane_current_command}", name: "cmd", scope: "all-panes" }
```

## Members

- `format` (property) — A tmux format string. See `FORMATS` in the tmux manual.
- `name` (property) — The caller's label, echoed back on every report.
- `scope` (property) — What the format is expanded against. Omitted expands once per session.