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
           <function>MongoDB::lastError</function>.
          </para>
+         <note>
+          <para>
+           Please note that <literal>continueOnError</literal> 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.
+           <literal>continueOnError</literal> has no effect on errors detected
+           in the documents by the driver.
+          </para>
+         </note>
         </listitem>
         &mongo.writes.parameters.safe; 
        </itemizedlist>