diff --git a/reference/mongo/mongocollection/batchinsert.xml b/reference/mongo/mongocollection/batchinsert.xml
index bfd8b4893b..37ce7d68c8 100644
--- a/reference/mongo/mongocollection/batchinsert.xml
+++ b/reference/mongo/mongocollection/batchinsert.xml
@@ -63,6 +63,17 @@
If multiple errors occur, only the most recent will be reported by
MongoDB::lastError.
+
+
+ Please note that continueOnError affects errors
+ on the database side only. If you try to insert a document that has
+ errors (for example it contains a key with an empty name), then the
+ document is not even transferred to the database as the driver
+ detects this error and bails out.
+ continueOnError has no effect on errors detected
+ in the documents by the driver.
+
+
&mongo.writes.parameters.safe;