diff --git a/source/data-formats/working-with-bson.txt b/source/data-formats/working-with-bson.txt
index 15cac4a3..73ec53d4 100644
--- a/source/data-formats/working-with-bson.txt
+++ b/source/data-formats/working-with-bson.txt
@@ -28,6 +28,11 @@ and supports additional types, including dates, different-sized integers, ``Obje
 values, and binary data. For a complete list of supported types, see the :manual:`BSON Types </reference/bson-types/>`
 page in the {+mdb-server+} manual. 
 
+.. note::
+   
+   Avoid adding duplicate keys to BSON documents. Although the `BSON specification <https://bsonspec.org/>`__ 
+   allows duplicate keys, they can cause unexpected behavior in {+mdb-server+}.
+
 BSON Values and Views
 ~~~~~~~~~~~~~~~~~~~~~