diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md
index 2612d6212279..e976b0ddb814 100644
--- a/docs/api/web-contents.md
+++ b/docs/api/web-contents.md
@@ -499,7 +499,14 @@ win.webContents.on("did-finish-load", function() {
 
 * `path` String
 
-Adds the specified path to DevTools workspace.
+Adds the specified path to DevTools workspace. Must be used after DevTools
+creation:
+
+```javascript
+mainWindow.webContents.on('devtools-opened', function() {
+  mainWindow.webContents.addWorkSpace(__dirname);
+});
+```
 
 ### `webContents.removeWorkSpace(path)`