symfony
diff --git a/‎reference/forms/types/collection.rst
Copy file name to clipboardExpand all lines: reference/forms/types/collection.rst
+9Lines changed: 9 additions & 0 deletions b/‎reference/forms/types/collection.rst
Copy file name to clipboardExpand all lines: reference/forms/types/collection.rst
+9Lines changed: 9 additions & 0 deletions
diff --git a/‎reference/forms/types/form.rst
Copy file name to clipboardExpand all lines: reference/forms/types/form.rst
+2Lines changed: 2 additions & 0 deletions b/‎reference/forms/types/form.rst
Copy file name to clipboardExpand all lines: reference/forms/types/form.rst
+2Lines changed: 2 additions & 0 deletions
@@ -273,6 +273,15 @@ form you have to set this option to true. However, existing collection entries
 will only be deleted if you have the allow_delete_ option enabled. Otherwise
 the empty values will be kept.
 
+.. caution::
+
+    The ``delete_empty`` option only removes items when the normalized value is
+    ``null``. If the nested `type`_ is a compound form type, you must either set
+    the ``required`` option to ``false`` or set the ``empty_data`` option to 
+    ``null``. Both of these options can be set inside `options`_. See
+    :ref:`form's empty_data option <reference-form-option-empty-data>` to learn
+    why this is necessary.
+
 options
 ~~~~~~~
 
 
@@ -80,6 +80,8 @@ option on the form.
 
 .. include:: /reference/forms/types/options/data_class.rst.inc
 
+.. _reference-form-option-empty-data:
+
 .. include:: /reference/forms/types/options/empty_data.rst.inc
     :end-before: DEFAULT_PLACEHOLDER