diff --git a/docs/config.json b/docs/config.json
index eeaae12b79e57..e402f651bacd8 100644
--- a/docs/config.json
+++ b/docs/config.json
@@ -31,7 +31,11 @@
             {
               "title": "Set up Automatic Agent Updates",
               "slug": "/upgrading/automatic-agent-updates/"
-            }
+            },
+            {
+              "title": "Upgrading Reference",
+              "slug": "/upgrading/upgrading-reference/"
+	    }
           ]
         },
         {
@@ -2626,7 +2630,12 @@
     },
     {
       "source": "/upgrading/reference/",
-      "destination": "/upgrading/upgrading/",
+      "destination": "/upgrading/upgrading-reference/",
+      "permanent": true
+    },
+    {
+      "source": "/upgrading/upgrading/",
+      "destination": "/upgrading/upgrading-reference/",
       "permanent": true
     },
     {
diff --git a/docs/pages/upgrading.mdx b/docs/pages/upgrading.mdx
index 474b4249b7f0b..c66546df6e21f 100644
--- a/docs/pages/upgrading.mdx
+++ b/docs/pages/upgrading.mdx
@@ -17,7 +17,7 @@ Teleport cluster. You can also set up automatic agent upgrades in a self-hosted
 Enterprise cluster.
 
 For more information about upgrading, for example, to upgrade manually, read the
-[Upgrading Reference](upgrading/upgrading.mdx).
+[Upgrading Reference](upgrading/upgrading-reference.mdx).
 
 You can find more information regarding the automatic updates architecture in the
 [Agent Update Management](reference/architecture/agent-update-management.mdx) page.
diff --git a/docs/pages/upgrading/automatic-agent-updates.mdx b/docs/pages/upgrading/automatic-agent-updates.mdx
index 5fa4656ac33f0..84de72dd84bb1 100644
--- a/docs/pages/upgrading/automatic-agent-updates.mdx
+++ b/docs/pages/upgrading/automatic-agent-updates.mdx
@@ -35,7 +35,7 @@ regular maintenance window.
 
 - A Teleport Enterprise cluster. If you do not have one, [sign
   up](https://goteleport.com/signup) for a free trial or consult the [Update
-  Reference](upgrading.mdx) to read about manual updates.
+  Reference](upgrading-reference.mdx) to read about manual updates.
 - Familiarity with the [Upgrading Compatibility Overview](./overview.mdx) guide,
   which describes the sequence in which to upgrade components in your cluster.
 - Teleport agents that are not yet enrolled in automatic updates.
diff --git a/docs/pages/upgrading/upgrading.mdx b/docs/pages/upgrading/upgrading-reference.mdx
similarity index 100%
rename from docs/pages/upgrading/upgrading.mdx
rename to docs/pages/upgrading/upgrading-reference.mdx