Implement place-within-backdrop layer rule

1 files changed, 22 insertions, 1 deletions

diff --git a/wiki/Configuration:-Layer-Rules.md b/wiki/Configuration:-Layer-Rules.md
index 84a8f7d6..8688295c 100644
--- a/wiki/Configuration:-Layer-Rules.md
+++ b/wiki/Configuration:-Layer-Rules.md
@@ -32,6 +32,8 @@ layer-rule {
     }
 
     geometry-corner-radius 12
+
+    place-within-backdrop true
 }
 ```
 
@@ -129,7 +131,7 @@ That is, enabling shadows in the layout config section won't automatically enabl
 // Add a shadow for fuzzel.
 layer-rule {
     match namespace="^launcher$"
-    
+
     shadow {
         on
     }
@@ -149,6 +151,25 @@ This setting will only affect the shadow—it will round its corners to match th
 
 ```kdl
 layer-rule {
+    match namespace="^launcher$"
+
     geometry-corner-radius 12
 }
 ```
+
+#### `place-within-backdrop`
+
+<sup>Since: next release</sup>
+
+Set to `true` to place the surface into the backdrop visible in the [Overview](./Overview.md) and between workspaces.
+
+This will only work for *background* layer surfaces that ignore exclusive zones (typical for wallpaper tools).
+
+```kdl
+// Put swaybg inside the overview backdrop.
+layer-rule {
+    match namespace="^wallpaper$"
+
+    place-within-backdrop true
+}
+```