diff --git a/doc/source/admin/identity-management.rst b/doc/source/admin/identity-management.rst
index 3c740b7ca1..7eb180e8b6 100644
--- a/doc/source/admin/identity-management.rst
+++ b/doc/source/admin/identity-management.rst
@@ -19,6 +19,7 @@ command-line client.
    identity-domain-specific-config.rst
    identity-external-authentication.rst
    identity-integrate-with-ldap.rst
+   identity-upgrading.rst
    identity-tokens.rst
    identity-token-binding.rst
    identity-fernet-token-faq.rst
diff --git a/doc/source/getting-started/upgrading.rst b/doc/source/admin/identity-upgrading.rst
similarity index 100%
rename from doc/source/getting-started/upgrading.rst
rename to doc/source/admin/identity-upgrading.rst
diff --git a/doc/source/getting-started/index.rst b/doc/source/getting-started/index.rst
index 912858e7ea..227b22fa65 100644
--- a/doc/source/getting-started/index.rst
+++ b/doc/source/getting-started/index.rst
@@ -6,7 +6,6 @@ Getting Started
     :maxdepth: 1
 
     installing.rst
-    upgrading.rst
     performance.rst
     architecture.rst
     policy_mapping.rst