diff --git a/docs/reference/high-availability/backup-and-restore-security-config.asciidoc b/docs/reference/high-availability/backup-and-restore-security-config.asciidoc
index 8cc2bc174e5..47fa196d2cb 100644
--- a/docs/reference/high-availability/backup-and-restore-security-config.asciidoc
+++ b/docs/reference/high-availability/backup-and-restore-security-config.asciidoc
@@ -18,8 +18,8 @@ Security configuration information resides in two places:
 `xpack.security` namespace>> inside the `elasticsearch.yml` and
 `elasticsearch.keystore` files. In addition there are several other
 <<security-files, extra configuration files>> inside the same `ES_PATH_CONF`
-directory. These files define roles and role mappings and
-<<configuring-file-realm, configure the file realm>>. Some of the
+directory. These files define roles and role mappings and configure the
+<<file-realm,file realm>>. Some of the
 settings specify file paths to security-sensitive data, such as TLS keys and
 certificates for the HTTP client and inter-node communication and private key files for
 <<ref-saml-settings, SAML>>, <<ref-oidc-settings, OIDC>> and the
diff --git a/docs/reference/redirects.asciidoc b/docs/reference/redirects.asciidoc
index 927b2904bb8..90c72c23965 100644
--- a/docs/reference/redirects.asciidoc
+++ b/docs/reference/redirects.asciidoc
@@ -945,3 +945,7 @@ See <<ref-saml-encryption-settings>>.
 
 See <<ref-saml-ssl-settings>>. 
 
+[role="exclude",id="configuring-file-realm"]
+=== Configuring a file realm
+
+See <<file-realm-configuration>>. 
diff --git a/docs/reference/upgrade/reindex_upgrade.asciidoc b/docs/reference/upgrade/reindex_upgrade.asciidoc
index 4beda3b5320..151506797f5 100644
--- a/docs/reference/upgrade/reindex_upgrade.asciidoc
+++ b/docs/reference/upgrade/reindex_upgrade.asciidoc
@@ -94,7 +94,7 @@ bin/elasticsearch-users userdel <user_name>
 ----------------------------------------------------------
 --
 
-For more information, see <<configuring-file-realm>>.
+For more information, see <<file-realm>>.
 ====
 endif::include-xpack[]
 
diff --git a/x-pack/docs/en/security/authentication/configuring-file-realm.asciidoc b/x-pack/docs/en/security/authentication/configuring-file-realm.asciidoc
index a3c034a7506..55a7fa2212c 100644
--- a/x-pack/docs/en/security/authentication/configuring-file-realm.asciidoc
+++ b/x-pack/docs/en/security/authentication/configuring-file-realm.asciidoc
@@ -1,8 +1,3 @@
-[role="xpack"]
-[[configuring-file-realm]]
-=== Configuring a file realm
-
-You can manage and authenticate users with the built-in `file` internal realm. 
 All the data about the users for the `file` realm is stored in two files on each 
 node in the cluster: `users` and `users_roles`. Both files are located in 
 `ES_PATH_CONF` and are read on startup.
@@ -22,8 +17,6 @@ or using a configuration management system such as Puppet or Chef).
 The `file` realm is added to the realm chain by default. You don't need to
 explicitly configure a `file` realm.
 
-For more information about file realms, see <<file-realm>>.
-
 . (Optional) Add a realm configuration to `elasticsearch.yml` under the
 `xpack.security.authc.realms.file` namespace. At a minimum, you must set 
 the realm's `order` attribute.
diff --git a/x-pack/docs/en/security/authentication/file-realm.asciidoc b/x-pack/docs/en/security/authentication/file-realm.asciidoc
index 9261c33eb1f..8603500954a 100644
--- a/x-pack/docs/en/security/authentication/file-realm.asciidoc
+++ b/x-pack/docs/en/security/authentication/file-realm.asciidoc
@@ -23,5 +23,7 @@ To define users, the {security-features} provide the
 {ref}/users-command.html[users] command-line tool. This tool enables you to add
 and remove users, assign user roles, and manage user passwords.
 
-For more information, see 
-{ref}/configuring-file-realm.html[Configuring a file realm].
+[[file-realm-configuration]]
+==== Configuring a file realm
+
+include::configuring-file-realm.asciidoc[]
diff --git a/x-pack/docs/en/security/configuring-es.asciidoc b/x-pack/docs/en/security/configuring-es.asciidoc
index 6cb9252f107..2d178f29356 100644
--- a/x-pack/docs/en/security/configuring-es.asciidoc
+++ b/x-pack/docs/en/security/configuring-es.asciidoc
@@ -73,7 +73,7 @@ your subscription. For more information, see https://www.elastic.co/subscription
  
 --
 ** <<configuring-ad-realm,Active Directory realms>>
-** <<configuring-file-realm,File realms>>
+** <<file-realm,File realms>>
 ** <<configuring-kerberos-realm,Kerberos realms>>
 ** <<configuring-ldap-realm,LDAP realms>>
 ** <<native-realm,Native realms>>
@@ -146,7 +146,6 @@ include::securing-communications/enabling-cipher-suites.asciidoc[]
 include::securing-communications/separating-node-client-traffic.asciidoc[]
 
 include::authentication/configuring-active-directory-realm.asciidoc[]
-include::authentication/configuring-file-realm.asciidoc[]
 include::authentication/configuring-ldap-realm.asciidoc[]
 include::authentication/configuring-pki-realm.asciidoc[]
 include::authentication/configuring-kerberos-realm.asciidoc[]
diff --git a/x-pack/docs/en/security/reference/files.asciidoc b/x-pack/docs/en/security/reference/files.asciidoc
index edf9c222dd0..bf6e1807f92 100644
--- a/x-pack/docs/en/security/reference/files.asciidoc
+++ b/x-pack/docs/en/security/reference/files.asciidoc
@@ -9,10 +9,10 @@ The {es} {security-features} use the following files:
 <<defining-roles>>.
 
 * `ES_PATH_CONF/elasticsearch-users` defines the users and their hashed passwords for
-  the `file` realm. See <<configuring-file-realm>>.
+  the `file` realm. See <<file-realm>>.
 
 * `ES_PATH_CONF/elasticsearch-users_roles` defines the user roles assignment for the
-  the `file` realm. See <<configuring-file-realm>>.
+  the `file` realm. See <<file-realm>>.
 
 * `ES_PATH_CONF/role_mapping.yml` defines the role assignments for a
   Distinguished Name (DN) to a role. This allows for LDAP and Active Directory