diff --git a/docs/api/frameless-window.md b/docs/api/frameless-window.md
index 6395a33dc7e2..3ef5cdc93e9e 100644
--- a/docs/api/frameless-window.md
+++ b/docs/api/frameless-window.md
@@ -28,12 +28,26 @@ hidden and your content extend to the full window size, yet still preserve
 the window controls ("traffic lights") for standard window actions.
 You can do so by specifying the new `titleBarStyle` option:
 
+#### `hidden`
+
+Results in a hidden title bar and a full size content window, yet the title bar still has the standard window controls (“traffic lights”) in the top left.
+
 ```javascript
 const {BrowserWindow} = require('electron')
 let win = new BrowserWindow({titleBarStyle: 'hidden'})
 win.show()
 ```
 
+#### `hidden-inset`
+
+Results in a hidden title bar with an alternative look where the traffic light buttons are slightly more inset from the window edge.
+
+```javascript
+const {BrowserWindow} = require('electron')
+let win = new BrowserWindow({titleBarStyle: 'hidden-inset'})
+win.show()
+```
+
 ## Transparent window
 
 By setting the `transparent` option to `true`, you can also make the frameless