diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md
index ec1003f2d8..1b10d9624c 100644
--- a/docs/api/web-contents.md
+++ b/docs/api/web-contents.md
@@ -155,7 +155,9 @@ requested by `window.open` or an external link like `<a target='_blank'>`.
 
 By default a new `BrowserWindow` will be created for the `url`.
 
-Calling `event.preventDefault()` will prevent creating new windows.
+Calling `event.preventDefault()` will prevent creating new windows. In such case, the
+`event.newGuest` may be set with a reference to a `BrowserWindow` instance to make it
+used by the Electron's runtime.
 
 #### Event: 'will-navigate'