diff --git a/docs/modules/ROOT/pages/how-tos/upgrade-7.x-to-8.x.adoc b/docs/modules/ROOT/pages/how-tos/upgrade-7.x-to-8.x.adoc
new file mode 100644
index 00000000..16d19c26
--- /dev/null
+++ b/docs/modules/ROOT/pages/how-tos/upgrade-7.x-to-8.x.adoc
@@ -0,0 +1,4 @@
+= Upgrade from v7 to v8
+
+There are no special steps required to upgrade from v7 to v8.
+However, note that this version upgrades Keycloak from v16 to v17, so once Keycloak executed the DB migrations, a downgrade won't be possible.
diff --git a/docs/modules/ROOT/partials/nav.adoc b/docs/modules/ROOT/partials/nav.adoc
index d56dc908..b8cf9250 100644
--- a/docs/modules/ROOT/partials/nav.adoc
+++ b/docs/modules/ROOT/partials/nav.adoc
@@ -19,6 +19,7 @@
 * xref:how-tos/upgrade-4.x-to-5.x.adoc[Upgrade 4.x to 5.x]
 * xref:how-tos/upgrade-5.x-to-6.x.adoc[Upgrade 5.x to 6.x]
 * xref:how-tos/upgrade-6.x-to-7.x.adoc[Upgrade 6.x to 7.x]
+* xref:how-tos/upgrade-7.x-to-8.x.adoc[Upgrade 7.x to 8.x]
 * xref:how-tos/openshift-4.adoc[Install on OpenShift 4]
 * xref:how-tos/pin-versions.adoc[Pin versions]