diff --git a/docs/reference/settings/security-settings.asciidoc b/docs/reference/settings/security-settings.asciidoc
index 48fd45c1d1e01..b5f03fe46292d 100644
--- a/docs/reference/settings/security-settings.asciidoc
+++ b/docs/reference/settings/security-settings.asciidoc
@@ -194,7 +194,7 @@ namespace in `elasticsearch.yml`. For example:
 ----------------------------------------
 xpack.security.authc.realms:
 
-    native.realm1:
+    native.realm1: <1>
         order: 0
         ...
 
@@ -207,6 +207,9 @@ xpack.security.authc.realms:
         ...
     ...
 ----------------------------------------
+<1> Specifies the type of realm (for example, `native`, `ldap`,
+`active_directory`, `pki`, `file`, `kerberos`, `saml`) and the realm name. This
+information is required.
 
 The valid settings vary depending on the realm type. For more
 information, see <<setting-up-authentication>>.
@@ -215,9 +218,6 @@ information, see <<setting-up-authentication>>.
 [[ref-realm-settings]]
 ===== Settings valid for all realms
 
-`type`::
-The type of the realm: `native`, `ldap`, `active_directory`, `pki`, or `file`. Required.
-
 `order`::
 The priority of the realm within the realm chain. Realms with a lower order are
 consulted first. Although not required, use of this setting is strongly