From bfad3a61088e5363b48b8fe29c3fec63238be98f Mon Sep 17 00:00:00 2001
From: Finn Evers <finn@zed.dev>
Date: Wed, 2 Sep 2026 18:54:48 +0000
Subject: [PATCH] docs: Document `focus_follows_mouse` (#63646)

Release Notes:

- N/A
---
 docs/src/reference/all-settings.md | 35 ++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/src/reference/all-settings.md b/docs/src/reference/all-settings.md
index 9dee351809..f38478d146 100644
--- a/docs/src/reference/all-settings.md
+++ b/docs/src/reference/all-settings.md
@@ -2014,6 +2014,41 @@ While other options may be changed at a runtime and should be placed under `sett
 }
 ```
 
+## Focus Follows Mouse
+
+- Description: Whether the focused panel follows the mouse location.
+- Setting: `focus_follows_mouse`
+- Default:
+
+```json [settings]
+{
+  "focus_follows_mouse": {
+    "enabled": false,
+    "debounce_ms": 250
+  }
+}
+```
+
+### Enabled
+
+- Description: Whether hovering over a dock or pane moves focus to it.
+- Setting: `enabled`
+- Default: `false`
+
+**Options**
+
+`boolean` values
+
+### Debounce
+
+- Description: How long the mouse must hover over a panel before it is focused, in milliseconds.
+- Setting: `debounce_ms`
+- Default: `250`
+
+**Options**
+
+Non-negative `integer` values
+
 ## Format On Save {#format-on-save}
 
 - Description: Whether or not to perform a buffer format before saving.