# extended-keys

Source: https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys/

> Controls how modified keys (keys pressed together with Control, Meta, or Shift) are reported.

option tmux3.7c

Controls how modified keys (keys pressed together with Control, Meta, or Shift) are reported.

* Scope

  server

* Type

  Choice

* Default

  `off`

* Values

  `off` `on` `always`

* Set

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

* Read

  [`show-options`](https://libtmux.org/en/tmux/3.7c/manual/show-options/) `-s extended-keys`

## Description[#](https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys/#description)

Controls how modified keys (keys pressed together with Control, Meta, or Shift) are reported. This is the equivalent of the `modifyOtherKeys`[xterm(1)]() resource.

When set to `on`, the program inside the pane can request one of two modes: mode 1 which changes the sequence for only keys which lack an existing well-known representation; or mode 2 which changes the sequence for all keys. When set to `always`, modes 1 and 2 can still be requested by applications, but mode 1 will be forced instead of the standard mode. When set to `off`, this feature is disabled and only standard keys are reported.

`tmux` will always request extended keys itself if the terminal supports them. See also the `extkeys` feature for the [`terminal-features`](https://libtmux.org/en/tmux/3.7c/catalog/options/terminal-features/) option, the [`extended-keys-format`](https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys-format/) option and the [`pane_key_mode`](https://libtmux.org/en/tmux/3.7c/catalog/formats/pane_key_mode/) variable.

## Releases[#](https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys/#releases)

* [tmux 3.7c](https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys/) : present
* [tmux 3.2a](https://libtmux.org/en/tmux/3.2a/catalog/options/extended-keys/) : present

## Source[#](https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys/#source)

* Defined in

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

* 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-extended-keys)

## Used by[#](https://libtmux.org/en/tmux/3.7c/catalog/options/extended-keys/#used-by)

Library documentation that names this option.

* Rust

  [`options.generated.EXTENDED_KEYS`](https://libtmux.org/en/rs/latest/reference/options-generated-extended_keys/)

* Go

  [`tmux.ExtendedKeys`](https://libtmux.org/en/go/latest/reference/tmux-extendedkeys/), [`tmux.Server.SetExtendedKeys`](https://libtmux.org/en/go/latest/reference/tmux-server-setextendedkeys/), [`tmux.ServerOptionValues.ExtendedKeys`](https://libtmux.org/en/go/latest/reference/tmux-serveroptionvalues-extendedkeys/)