diff --git a/docs/reference/migration/migrate_8_0.asciidoc b/docs/reference/migration/migrate_8_0.asciidoc
index 56a9f582142b7..48c883c6197d9 100644
--- a/docs/reference/migration/migrate_8_0.asciidoc
+++ b/docs/reference/migration/migrate_8_0.asciidoc
@@ -17,6 +17,7 @@ coming[8.0.0]
 * <<breaking_80_packaging_changes>>
 * <<breaking_80_snapshots_changes>>
 * <<breaking_80_security_changes>>
+* <<breaking_80_ilm_changes>>
 * <<breaking_80_java_changes>>
 
 //NOTE: The notable-breaking-changes tagged regions are re-used in the
@@ -46,4 +47,5 @@ include::migrate_8_0/mappings.asciidoc[]
 include::migrate_8_0/packaging.asciidoc[]
 include::migrate_8_0/snapshots.asciidoc[]
 include::migrate_8_0/security.asciidoc[]
+include::migrate_8_0/ilm.asciidoc[]
 include::migrate_8_0/java.asciidoc[]
diff --git a/docs/reference/migration/migrate_8_0/ilm.asciidoc b/docs/reference/migration/migrate_8_0/ilm.asciidoc
new file mode 100644
index 0000000000000..e18b39a0d7d9e
--- /dev/null
+++ b/docs/reference/migration/migrate_8_0/ilm.asciidoc
@@ -0,0 +1,17 @@
+[float]
+[[breaking_80_ilm_changes]]
+=== Index Lifecycle Management changes
+
+//NOTE: The notable-breaking-changes tagged regions are re-used in the
+//Installation and Upgrade Guide
+
+//tag::notable-breaking-changes[]
+
+// end::notable-breaking-changes[]
+
+[float]
+[[ilm-poll-interval-limit]]
+==== `indices.lifecycle.poll_interval` must be greater than 1 second
+
+The setting `indices.lifecycle.poll_interval`, if set too low, can cause
+excessive load on a cluster. This setting must now be set to 1 second or higher.