diff --git a/docs/reference/migration/migrate_7_0/indices.asciidoc b/docs/reference/migration/migrate_7_0/indices.asciidoc
index 634a00e1f44..1135c63f421 100644
--- a/docs/reference/migration/migrate_7_0/indices.asciidoc
+++ b/docs/reference/migration/migrate_7_0/indices.asciidoc
@@ -2,6 +2,11 @@
 [[breaking_70_indices_changes]]
 === Indices changes
 
+[float]
+==== Index creation no longer defaults to five shards
+Previous versions of Elasticsearch defaulted to creating five shards per index.
+Starting with 7.0.0, the default is now one index per shard.
+
 [float]
 ==== `:` is no longer allowed in index name