diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index a829e390ae97..ab7766981dc9 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -97,8 +97,10 @@ You can also create a window without chrome by using
     * `shared-worker` Boolean
     * `direct-write` Boolean - Whether the DirectWrite font rendering system on
        Windows is enabled
-    * `page-visibility` Boolean - Sets the page visibility state
-       to visible, prevents throttling of DOM timers.
+    * `page-visibility` Boolean - Page would be forced to be always in visible
+       or hidden state once set, instead of reflecting current window's
+       visibility. Users can set it to `true` to prevent throttling of DOM
+       timers.
 
 Creates a new `BrowserWindow` with native properties set by the `options`.
 Usually you only need to set the `width` and `height`, other properties will