diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index e051923a693..0c012abfe53 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -1316,6 +1316,11 @@ The configuration of how to source the analysis data. It requires an
   (Required, string or array) Index or indices on which to perform the 
   analysis. It can be a single index or index pattern as well as an array of 
   indices or patterns.
++
+--
+WARNING: If your source indices contain documents with the same IDs, only the 
+document that is indexed last appears in the destination index.
+--
   
 `query`:::
   (Optional, object) The {es} query domain-specific language