Add workspace-shadow {} config to overview {}

2 files changed, 28 insertions, 0 deletions

diff --git a/wiki/Configuration:-Miscellaneous.md b/wiki/Configuration:-Miscellaneous.md
index 5f4a8e7c..ee78cebd 100644
--- a/wiki/Configuration:-Miscellaneous.md
+++ b/wiki/Configuration:-Miscellaneous.md
@@ -26,6 +26,14 @@ cursor {
 overview {
     zoom 0.5
     backdrop-color "#262626"
+
+    workspace-shadow {
+        // off
+        softness 120
+        spread 20
+        offset x=0 y=20
+        color "#00000070"
+    }
 }
 
 clipboard {
@@ -178,6 +186,24 @@ overview {
 }
 ```
 
+#### `workspace-shadow`
+
+Control the shadow behind workspaces visible in the overview.
+
+Settings here mirror the normal [`shadow` config in the layout section](./Configuration:-Layout.md#shadow), so check the documentation there.
+
+Keep in mind that workspace shadows are configured for the full-screen workspace size, then zoomed out together with the workspace.
+Practically, this means that you'll want bigger spread, offset, and softness compared to window shadows.
+
+```kdl
+// Disable workspace shadows in the overview.
+overview {
+    workspace-shadow {
+        off
+    }
+}
+```
+
 ### `clipboard`
 
 <sup>Since: 25.02</sup>
diff --git a/wiki/Overview.md b/wiki/Overview.md
index 57629c2e..c907eb67 100644
--- a/wiki/Overview.md
+++ b/wiki/Overview.md
@@ -29,6 +29,8 @@ https://github.com/user-attachments/assets/b76d5349-aa20-4889-ab90-0a51554c789d
 
 ### Configuration
 
+See the full documentation for the `overview {}` section [here](./Configuration:-Miscellaneous.md#overview).
+
 You can set the zoom-out level like this:
 
 ```kdl