diff --git a/readme.org b/readme.org
index 84a453d..e5343df 100644
--- a/readme.org
+++ b/readme.org
@@ -19,6 +19,8 @@ Workflow builds can be customised by editing one of the [[#build-examples][examp
 
 The [[#keyboard-keymaps][keyboard keymap]] includes the config file, the [[#miryoku-keymap][Miryoku keymap]], and a [[#mapping][mapping]] for the physical layout.
 
+[[#additional-and-experimental-features][Additional and Experimental Features]] include [[#mouse-keys][mouse keys on the host]]
+
 
 ** Building
 
@@ -238,6 +240,18 @@ The thumb keys are moved 1u to extend the thumbs.  Supports ortho configuration.
 Keymap files for many keyboards are provided in [[config]].
 
 
+** Additional and Experimental Features
+
+
+*** Mouse Keys
+
+The Mouse and Button layer use [[https://en.wikipedia.org/wiki/Mouse_keys][mouse keys on the host]].  Middle button, right button, and scroll are not supported.
+
+- [[https://linuxreviews.org/HOWTO_use_the_numeric_keyboard_keys_as_mouse_in_XOrg][X11]]
+- [[https://support.apple.com/en-au/guide/mac-help/mh27469/mac][Mac]]
+- [[https://support.microsoft.com/en-us/windows/use-mouse-keys-to-move-the-mouse-pointer-9e0c72c8-b882-7918-8e7b-391fd62adf33][Windows]]
+
+
 ** 
 
 [[https://github.com/manna-harbour][https://raw.githubusercontent.com/manna-harbour/miryoku/master/data/logos/manna-harbour-boa-32.png]]