symfony
diff --git a/‎reference/forms/types/form.rst
Copy file name to clipboardExpand all lines: reference/forms/types/form.rst
+3Lines changed: 3 additions & 0 deletions b/‎reference/forms/types/form.rst
Copy file name to clipboardExpand all lines: reference/forms/types/form.rst
+3Lines changed: 3 additions & 0 deletions
diff --git a/‎reference/forms/types/options/form_attr.rst.inc
Copy file name to clipboard
+26Lines changed: 26 additions & 0 deletions b/‎reference/forms/types/options/form_attr.rst.inc
Copy file name to clipboard
+26Lines changed: 26 additions & 0 deletions
@@ -19,6 +19,7 @@ on all types for which ``FormType`` is the parent.
 |                           | - `error_bubbling`_                                                |
 |                           | - `error_mapping`_                                                 |
 |                           | - `extra_fields_message`_                                          |
+|                           | - `form_attr`_                                                     |
 |                           | - `help`_                                                          |
 |                           | - `help_attr`_                                                     |
 |                           | - `help_html`_                                                     |
@@ -116,6 +117,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/extra_fields_message.rst.inc
 
+.. include:: /reference/forms/types/options/form_attr.rst.inc
+
 .. include:: /reference/forms/types/options/help.rst.inc
 
 .. include:: /reference/forms/types/options/help_attr.rst.inc
 
@@ -0,0 +1,26 @@
+``form_attr``
+~~~~~~~~~~~~~
+
+**type**: ``bool`` or ``string`` **default**: ``false``
+
+When ``true`` and used on a form element, it adds a `"form" attribute`_. to its HTML field representation with
+its HTML form id. By doing this, form element can be rendered outside HTML form while still working as expected::
+
+    $builder->add('body', TextareaType::class, [
+        'form_attr' => true,
+    ]);
+
+This can be useful when you need to solve nested form problems.
+You can also set this to ``true`` on a root form to automatically set the "form" attribute on all its children.
+
+.. note::
+
+    When root form has no ID, ``form_attr`` required to be a string identifier to be used as form ID.
+
+.. caution::
+
+    HTML "form" attribute was introduced to let you explicitly bind a control with a form even if it is
+    not nested inside it. Don't forget to check for `browser compatibility`_.
+
+.. _`"form" attribute`: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#attr-fae-form
+.. _`browser compatibility`: https://caniuse.com/form-attribute