diff --git a/docs/customization/keybindings.mdx b/docs/customization/keybindings.mdx index 63ad7344..cc699d7c 100644 --- a/docs/customization/keybindings.mdx +++ b/docs/customization/keybindings.mdx @@ -56,8 +56,14 @@ An action's value takes one of two shapes: | `""` or `[]` | **Unbind** the action | Recording a shortcut on the Settings page replaces, so it writes the list -shape. A shortcut you add that another action already uses wins: it is the one -that runs. +shape. A shortcut you add that another action already uses is the one that +runs. The exception is the terminal's own shortcuts: copy, paste, find, clear +scrollback and insert newline keep theirs while a terminal has focus. + +Up to 26.9.2 a string replaced the default, and the Settings page wrote +strings. So a shortcut you recorded in those versions now works *beside* the +default it was meant to replace. To drop the default again, record the shortcut again +or wrap it in a list: `"NewTab": ["cmd-shift-n"]`. The syntax is modifiers joined by `-`, then the key. Chords are separated by a space.