diff --git a/docs/src/debugger.md b/docs/src/debugger.md
index 88d5dc78f165bd..f8b064523e347a 100644
--- a/docs/src/debugger.md
+++ b/docs/src/debugger.md
@@ -56,6 +56,22 @@ Check the documentation for your language for example configurations covering ty
 
 Zed will also load debug configurations from `.vscode/launch.json`, and show them in the new process modal if no configurations are found in `.zed/debug.json`.
 
+### Global Debug Configurations
+
+Debug configurations can be defined globally and will be available across all your projects. Global configurations are stored in:
+- `~/.config/zed/debug.json` on Linux and macOS
+- `%APPDATA%\Zed\debug.json` on Windows
+and follow the same format as project-specific configurations.
+
+Global configurations are loaded alongside project-specific ones, allowing you to:
+- Define common debug setups that work across all projects
+- Share debug configurations with your team  
+- Set up language-specific debuggers that apply everywhere
+
+To open the global debug configuration file, use the {#action zed::OpenDebugTasks} action from the command palette.
+
+**Configuration Precedence**: When both global and project-specific configurations exist, both are available in the debug modal. Project-specific configurations don't override global ones - they are shown alongside them, giving you access to all configured debug scenarios.
+
 ### Launching & Attaching
 
 Zed debugger offers two ways to debug your program; you can either _launch_ a new instance of your program or _attach_ to an existing process.