diff --git a/docs/usage/configuration-options.md b/docs/usage/configuration-options.md
index 62ab4d627d8486d7b9c22a592677b2c99442943e..0c4a7a021f802bd47c222ab2e194eb8f27080f41 100644
--- a/docs/usage/configuration-options.md
+++ b/docs/usage/configuration-options.md
@@ -283,6 +283,8 @@ For `npm` only you can also configure this field to `"mirror:x"` where `x` is th
 Doing so means that the `package.json` `version` field will mirror whatever the version is that `x` depended on.
 Make sure that version is a pinned version of course, as otherwise it won't be valid.
 
+For `sbt` note that Renovate will update the version string only for packages that have the version string in their project's `built.sbt` file.
+
 ## cloneSubmodules
 
 ## commitBody