diff --git a/README.md b/README.md
index e91f0be..dc3cd6d 100644
--- a/README.md
+++ b/README.md
@@ -147,7 +147,11 @@ Available application actions can be listed like this:
 app.action_group.list_actions();
 ```
 
-### User-defined keybindings
+### Keybindings
+
+Due to limitations in the mutter keybinding API we need to steal some built in Gnome Shell actions by default. Eg. the builtin action `switch-group` with the default <kbd>Super</kbd><kbd>Above_Tab</kbd> keybinding is overriden to cycle through recently used workspaces. If an overriden action have several keybindings they will unfortunately all activate the override, so for instance because <kbd>Alt</kbd><kbd>Above_Tab</kbd> is also bound to `switch-group` it will be overriden by default. If you want to avoid this, eg. you want <kbd>Alt</kbd><kbd>Tab</kbd> and <kbd>Alt</kbd><kbd>Above_Tab</kbd> to use the builtin behavior simply remove the conflicts (ie. <kbd>Super</kbd><kbd>Tab</kbd> and <kbd>Super</kbd><kbd>Above_Tab</kbd> and their <kbd>Shift</kbd> variants) from `/org/gnome/desktop/wm/keybindings/switch-group` (no restarts required).
+
+#### User defined keybindings
 
 `Extension.imports.keybindings.bindkey(keystr, name, handler, options)`