diff --git a/docs/en/install-upgrade/breaking.asciidoc b/docs/en/install-upgrade/breaking.asciidoc
index 859c38d4d..414d3a43b 100644
--- a/docs/en/install-upgrade/breaking.asciidoc
+++ b/docs/en/install-upgrade/breaking.asciidoc
@@ -7,7 +7,7 @@ use and make the necessary changes so your code is compatible with {version}.
 ** <<apm-breaking-changes,APM {version} breaking changes>>
 ** <<beats-breaking-changes,Beats {version} breaking changes>>
 ** <<elasticsearch-breaking-changes,{es} {version} breaking changes>>
-** {hadoop-ref}/breaking-changes.html[Elasticsearch Hadoop {version} breaking changes]
+** <<elasticsearch-hadoop-breaking-changes,{es} Hadoop {version} breaking changes>>
 ** <<kibana-breaking-changes,Kibana {version} breaking changes>>
 ** {logstash-ref}/breaking-changes.html[Logstash {version} breaking changes]
 
@@ -63,6 +63,21 @@ the complete list, go to {ref}/breaking-changes.html[{es} breaking changes].
 
 include::{es-repo-dir}/reference/migration/migrate_8_0.asciidoc[tag=notable-breaking-changes]
 
+[[elasticsearch-hadoop-breaking-changes]]
+=== {es} Hadoop breaking changes
+[subs="attributes"]
+++++
+<titleabbrev>{es} Hadoop</titleabbrev>
+++++
+
+coming[8.0.0]
+
+This list summarizes the most important breaking changes in {es} Hadoop {version}.
+For the complete list, go to
+{hadoop-ref}/breaking-changes.html[Elasticsearch Hadoop breaking changes].
+
+include::{hadoop-repo-dir}/appendix/breaking.adoc[tag=notable-v8-breaking-changes]
+
 [[kibana-breaking-changes]]
 === {kib} breaking changes
 [subs="attributes"]
diff --git a/docs/en/install-upgrade/index.asciidoc b/docs/en/install-upgrade/index.asciidoc
index 2fa9992b4..c801537d8 100644
--- a/docs/en/install-upgrade/index.asciidoc
+++ b/docs/en/install-upgrade/index.asciidoc
@@ -1,10 +1,11 @@
 [[elastic-stack]]
 = Installation and Upgrade Guide
 
+:apm-repo-dir:       {docdir}/../../../../apm-server/docs/guide
+:beats-repo-dir:     {docdir}/../../../../beats/libbeat/docs
 :es-repo-dir:        {docdir}/../../../../elasticsearch/docs
+:hadoop-repo-dir:    {docdir}/../../../../elasticsearch-hadoop/docs/src/reference/asciidoc
 :kib-repo-dir:       {docdir}/../../../../kibana/docs
-:beats-repo-dir:     {docdir}/../../../../beats/libbeat/docs
-:apm-repo-dir:       {docdir}/../../../../apm-server/docs/guide
 
 include::{asciidoc-dir}/../../shared/attributes.asciidoc[]
 include::{es-repo-dir}/Versions.asciidoc[]