Emacs: How to Define Keybinding

By Xah Lee. Date: . Last updated: .

In emacs, you can create any keyboard shortcut to any command.

For example, if you want F9 for whitespace-mode, put this in your Emacs Init File:

(global-set-key (kbd "<f9>") 'whitespace-mode)

If you are experimenting, and don't want to restart emacs every time you try to define a new key, you can place cursor at the end of parenthesis and Alt + x eval-last-sexpCtrl + x Ctrl + e】. The new key will be active right away. [see Evaluate Emacs Lisp Code]

If you made some mistake and need to start emacs without loading your init file, you can start emacs from terminal like this: emacs -q.

What is Meta key

Keybinding Syntax

Remove a Keybinding

To unset a keybinding, set it to nil.

;; unset a key
(global-set-key (kbd "C-b") nil)

Find the Command of a Given Key

Alt + x describe-key, then type the key combination.

List Current Major Mode's Keys

Alt + x describe-mode. [see Emacs: What is Major Mode]

List ALL Keybinding

Alt + x describe-bindings.

Each Major Mode or Minor Mode usually add or change some keys. So, key list generated is specific to current buffer.

Swap CapsLock and Control Key

You cannot do it within emacs, because CapsLock is intercepted at the Operating System level, emacs does not see it. See:

Keys to Avoid

Emacs has its quirks. It's best not to define the following keys.

Good Key Choices

Emacs has some 7 thousand commands. By default, 800 of them have key shortcuts. [see A Curious Look at Emacs One Thousand Keybindings] All the common key spots are used. If you define your own keys without care, you may find that many major mode or minor mode override your keys, because they have priority.

By official emacs documentation (info "(elisp) Key Binding Conventions"), the key space reserved for users are the function keys F5 to F9, and Ctrl + c letter. This is very restrictive.

The following keys are good spots for your own definitions, and does not cause any problems in practice.

F5, F6, F7, F8, F9, F11, F12
Not defined by emacs. Combination with Alt or Ctrl or Shift is also good. Make sure they are not used by the OS. Best is to create key sequence with them. [see Emacs: Define Key Sequence]
F1, F2, F3, F4, F10, F11
Their default commands are not frequently used, or, better with other keys. [see Emacs Key Layout Diagram]
Ctrl + 0 to Ctrl + 9, Alt + 0 to Alt + 9
By default they are digit-argument. Such is not very frequently used. If you need them, use the more general universal-argumentCtrl + u】 instead.
Number Pad Keys
Very useful, but depending on which emacs distro/OS you are using, or if you use emacs in terminal or GUI, binding these keys may not work. [see Emacs: Bind Number Pad Keys]

Practical Examples

Emacs Custom Keybinding to Enhance Productivity.

System Wide Keybinding Setup

Get Programable Keyboard

These days, best option is to get a programable keyboard. This way, you don't have to worry about Operating System keyboard config. Just plug it in any computer and the keys do what you want.

see Programable Keyboards with Onboard Memory


Emacs Keys



Key Tips

Emacs Pinky