symfony
diff --git a/‎reference/forms/types/form.rst
Copy file name to clipboardExpand all lines: reference/forms/types/form.rst
+3-1Lines changed: 3 additions & 1 deletion b/‎reference/forms/types/form.rst
Copy file name to clipboardExpand all lines: reference/forms/types/form.rst
+3-1Lines changed: 3 additions & 1 deletion
diff --git a/‎reference/forms/types/options/mapped.rst.inc
Copy file name to clipboard
+7Lines changed: 7 additions & 0 deletions b/‎reference/forms/types/options/mapped.rst.inc
Copy file name to clipboard
+7Lines changed: 7 additions & 0 deletions
diff --git a/‎reference/forms/types/options/property_path.rst.inc
Copy file name to clipboardExpand all lines: reference/forms/types/options/property_path.rst.inc
+6-1Lines changed: 6 additions & 1 deletion b/‎reference/forms/types/options/property_path.rst.inc
Copy file name to clipboardExpand all lines: reference/forms/types/options/property_path.rst.inc
+6-1Lines changed: 6 additions & 1 deletion
@@ -19,8 +19,10 @@ on all fields.
 
 .. include:: /reference/forms/types/options/trim.rst.inc
 
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
 .. include:: /reference/forms/types/options/property_path.rst.inc
 
 .. include:: /reference/forms/types/options/attr.rst.inc
 
-.. include:: /reference/forms/types/options/translation_domain.rst.inc
+.. include:: /reference/forms/types/options/translation_domain.rst.inc
@@ -0,0 +1,7 @@
+mapped
+~~~~~~
+
+**type**: ``boolean``
+
+If you wish the field to be ignored when reading or writing to the object, you
+can set the ``mapped`` option to ``false``
@@ -11,4 +11,9 @@ you can set the ``property_path`` option. Its default value is the field's
 name.
 
 If you wish the field to be ignored when reading or writing to the object 
-you can set the ``property_path`` option to ``false``
+you can set the ``property_path`` option to ``false``, but using
+``property_path`` for this purpose is deprecated, you should do it the way
+described below:
+
+.. versionadded:: 2.1
+    Since 2.1, the ``mapped`` option has been added for this use-case.