wiki: Document named workspaces

1 files changed, 18 insertions, 0 deletions

diff --git a/wiki/Configuration:-Window-Rules.md b/wiki/Configuration:-Window-Rules.md
index f1be4680..d4b50f3b 100644
--- a/wiki/Configuration:-Window-Rules.md
+++ b/wiki/Configuration:-Window-Rules.md
@@ -37,6 +37,7 @@ window-rule {
     // Properties that apply once upon window opening.
     default-column-width { proportion 0.75; }
     open-on-output "eDP-1"
+    open-on-workspace "chat"
     open-maximized true
     open-fullscreen true
 
@@ -234,6 +235,23 @@ window-rule {
 }
 ```
 
+#### `open-on-workspace`
+
+Make the window open on a specific [named workspace](./Configuration:-Named-Workspaces.md).
+
+If such a workspace does not exist, the window will open on the currently focused workspace as usual.
+
+If the window opens on an output that is not currently focused, the window will not be automatically focused.
+
+```
+// Open Telegram on the "chat" workspace.
+window-rule {
+    match app-id=r#"^org\.telegram\.desktop$"#
+
+    open-on-workspace "chat"
+}
+```
+
 #### `open-maximized`
 
 Make the window open as a maximized column.