diff --git a/docs/api.md b/docs/api.md
index 979686883ba..a5c4520f131 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -1186,6 +1186,8 @@ await page.keyboard.press('KeyA');
 await page.keyboard.up('Shift');
 ```
 
+> **NOTE** On MacOS, keyboard shortcuts like `⌘ A` -> Select All do not work. See [#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)
+
 #### keyboard.down(key[, options])
 - `key` <[string]> Name of key to press, such as `ArrowLeft`. See [USKeyboardLayout] for a list of all key names.
 - `options` <[Object]>