diff --git a/README.rst b/README.rst
index c00b43c..d462f8c 100644
--- a/README.rst
+++ b/README.rst
@@ -176,6 +176,18 @@ screen.
 To select text (e.g., to copy to the clipboard), hold Shift while
 selecting the text.
 
+MacOS
+~~~~~
+
+The MacOS terminal blocks ctrl+o, which is the default search key combo in
+Gertty. To fix this, a custom keymap can be used on MacOS which modifies the
+search key combo. For example::
+
+  keymaps:
+    - name: default # MacOS blocks ctrl+o
+      change-search: 'ctrl s'
+      interactive-search: 'ctrl i'
+
 Terminal Integration
 --------------------
 
diff --git a/examples/reference-gertty.yaml b/examples/reference-gertty.yaml
index 5ace3ff..19b5407 100644
--- a/examples/reference-gertty.yaml
+++ b/examples/reference-gertty.yaml
@@ -107,7 +107,7 @@ keymaps:
     diff: 'd'
   - name: custom
     review: ['r', 'R']
-  - name: osx # OS X blocks ctrl+o
+  - name: osx # MacOS blocks ctrl+o
     change-search: 'ctrl s'
 # To specify a sequence of keys, they must be a list of keystrokes
 # within a list of key series.  For example: