diff --git a/docs/reference/migration/migrate_1_0.asciidoc b/docs/reference/migration/migrate_1_0.asciidoc
index 45fc6981fb9..cbac9dea4d5 100644
--- a/docs/reference/migration/migrate_1_0.asciidoc
+++ b/docs/reference/migration/migrate_1_0.asciidoc
@@ -250,6 +250,10 @@ you can now write:
 
 Existing multi-fields will be upgraded to the new format automatically.
 
+Also, instead of having to use the arcane `path` and `index_name` parameters
+in order to index multiple fields into a single ``custom +_all+ field'', you
+can now use the <<copy-to,`copy_to` parameter>>.
+
 == Stopwords
 
 Previously, the <<analysis-standard-analyzer,`standard`>> and