diff --git a/docs/documentation/topics/templates/document-attributes.adoc b/docs/documentation/topics/templates/document-attributes.adoc
index 9007ade1da2..68a48080c0d 100644
--- a/docs/documentation/topics/templates/document-attributes.adoc
+++ b/docs/documentation/topics/templates/document-attributes.adoc
@@ -71,6 +71,8 @@
 :developerguide_actiontoken_name: Action Token Handler SPI
 :developerguide_actiontoken_link: {developerguide_link}#_action_token_handler_spi
 :developerguide_jsproviders_name: JavaScript Providers
+:developerguide_userstoragespi_link: {developerguide_link}#_user-storage-spi
+:developerguide_userstoragespi_name: User Storage SPI
 :developerguide_jsproviders_link: {developerguide_link}#_script_providers
 :importexportguide_link: https://www.keycloak.org/nightly/server/importExport
 :gettingstarted_name: Getting Started Guide
diff --git a/docs/guides/attributes.adoc b/docs/guides/attributes.adoc
index a758b645bf5..2914e7fb1f4 100644
--- a/docs/guides/attributes.adoc
+++ b/docs/guides/attributes.adoc
@@ -30,6 +30,8 @@
 :quickstartRepo_dir: keycloak-quickstarts
 :securing_apps_link: https://www.keycloak.org/guides#securing-apps
 :upgrading_guide_link: {project_doc_base_url}/upgrading/
+:developerguide_userstoragespi_link: {developerguide_link}#_user-storage-spi
+:developerguide_userstoragespi_name: User Storage SPI
 :kc_js_path: /js
 :kc_realms_path: /realms
 :kubernetes: Kubernetes
diff --git a/docs/guides/server/db.adoc b/docs/guides/server/db.adoc
index efece59a822..efcd10e90bd 100644
--- a/docs/guides/server/db.adoc
+++ b/docs/guides/server/db.adoc
@@ -368,7 +368,7 @@ to be your `wait_timeout` minus a few minutes. Failure to correctly configure th
 
 {project_name} allows you to specify additional datasources in case you need to access another database from your extensions. This is useful when using the main {project_name} datasource is not a viable option for storing custom data, like users.
 
-You can find more details on how to connect to your own users database in the link:{server_developer_guide}#_user-storage-spi[User Storage SPI] documentation.
+You can find more details on how to connect to your own users database in the link:{developerguide_userstoragespi_link}[{developerguide_userstoragespi_name}] documentation.
 
 Defining multiple datasources works like defining a single datasource, with one important change - you have to specify a name for each datasource as part of the config option name.