diff --git a/docs/src/main/asciidoc/security-keycloak-authorization.adoc b/docs/src/main/asciidoc/security-keycloak-authorization.adoc
index 622dd26ac9d202..a46d434bede7b9 100644
--- a/docs/src/main/asciidoc/security-keycloak-authorization.adoc
+++ b/docs/src/main/asciidoc/security-keycloak-authorization.adoc
@@ -334,6 +334,12 @@ export access_token=$(\
  )
 ----
 
+[NOTE]
+====
+If the setting below is set, you should add the openid to the scope in the query parameters.
+`quarkus.oidc.authentication.user-info-required=true`
+====
+
 The preceding example obtains an access token for user `alice`.
 
 Any user is allowed to access the
diff --git a/docs/src/main/asciidoc/security-oidc-bearer-token-authentication-tutorial.adoc b/docs/src/main/asciidoc/security-oidc-bearer-token-authentication-tutorial.adoc
index e121297f002e38..a1cd486808dd5b 100644
--- a/docs/src/main/asciidoc/security-oidc-bearer-token-authentication-tutorial.adoc
+++ b/docs/src/main/asciidoc/security-oidc-bearer-token-authentication-tutorial.adoc
@@ -319,6 +319,12 @@ export access_token=$(\
 ----
 ====
 
+[NOTE]
+====
+If the setting below is set, you should add the openid to the scope in the query parameters.
+`quarkus.oidc.authentication.user-info-required=true`
+====
+
 The preceding example obtains an access token for the user `alice`.
 
 * Any user can access the `http://localhost:8080/api/users/me` endpoint, which returns a JSON payload with details about the user.