diff --git a/akka-docs/rst/java/distributed-data.rst b/akka-docs/rst/java/distributed-data.rst
index a038405a88..eaad6863d2 100644
--- a/akka-docs/rst/java/distributed-data.rst
+++ b/akka-docs/rst/java/distributed-data.rst
@@ -240,6 +240,14 @@ Subscribers will receive ``Replicator.DataDeleted``.
 
 .. includecode:: code/docs/ddata/DistributedDataDocTest.java#delete
 
+.. warning::
+
+  As deleted keys continue to be included in the stored data on each node as well as in gossip 
+  messages, a continuous series of updates and deletes of top-level entities will result in 
+  growing memory usage until an ActorSystem runs out of memory. To use Akka Distributed Data 
+  where frequent adds and removes are required, you should use a fixed number of top-level data 
+  types that support both updates and removals, for example ``ORMap`` or ``ORSet``.
+
 Data Types
 ==========
 
diff --git a/akka-docs/rst/scala/distributed-data.rst b/akka-docs/rst/scala/distributed-data.rst
index 9eea9c8a4c..4e0ba1dd9d 100644
--- a/akka-docs/rst/scala/distributed-data.rst
+++ b/akka-docs/rst/scala/distributed-data.rst
@@ -240,6 +240,14 @@ Subscribers will receive ``Replicator.DataDeleted``.
 
 .. includecode:: code/docs/ddata/DistributedDataDocSpec.scala#delete
 
+.. warning::
+
+  As deleted keys continue to be included in the stored data on each node as well as in gossip 
+  messages, a continuous series of updates and deletes of top-level entities will result in 
+  growing memory usage until an ActorSystem runs out of memory. To use Akka Distributed Data 
+  where frequent adds and removes are required, you should use a fixed number of top-level data 
+  types that support both updates and removals, for example ``ORMap`` or ``ORSet``.
+
 Data Types
 ==========