diff --git a/doc/metals.txt b/doc/metals.txt
index 692756b..e26a870 100644
--- a/doc/metals.txt
+++ b/doc/metals.txt
@@ -179,6 +179,7 @@ _ones that are sent and used by the server_
   * |autoImportBuild|
   * |bloopSbtAlreadyInstalled|
   * |bloopVersion|
+  * |defaultBspToBuildTool|
   * |enableSemanticHighlighting|
   * |excludedPackages|
   * |fallbackScalaVersion|
@@ -260,6 +261,14 @@ The highlight group that will be used to show decorations. For example, this
 will change the way worksheet evaluations are displayed in `*.worksheet.sc`
 file.
 
+defaultBspToBuildTool                                    *defaultBspToBuildTool*
+
+Type: boolean ~
+Default: false ~
+
+When your build tool can also serve as your build server, default to using it
+for BSP. The default is Bloop for build tools that Bloop supports.
+
                                                                   *disabledMode*
 Type: boolean ~
 Default: false ~
diff --git a/lua/metals/config.lua b/lua/metals/config.lua
index 532a354..769e05f 100644
--- a/lua/metals/config.lua
+++ b/lua/metals/config.lua
@@ -114,6 +114,7 @@ local valid_metals_settings = {
   "autoImportBuild",
   "bloopSbtAlreadyInstalled",
   "bloopVersion",
+  "defaultBspToBuildTool",
   "enableSemanticHighlighting",
   "excludedPackages",
   "fallbackScalaVersion",