diff --git a/typo3/sysext/form/Documentation/I/Config/proto/formElements/formElementTypes/Form/renderingOptions/templateVariant.rst b/typo3/sysext/form/Documentation/I/Config/proto/formElements/formElementTypes/Form/renderingOptions/templateVariant.rst
index f4754f8e447530aa14ec60ee9d9954d4d4139da3..5e902bf8806ef502b031438db3b248c0c441da72 100644
--- a/typo3/sysext/form/Documentation/I/Config/proto/formElements/formElementTypes/Form/renderingOptions/templateVariant.rst
+++ b/typo3/sysext/form/Documentation/I/Config/proto/formElements/formElementTypes/Form/renderingOptions/templateVariant.rst
@@ -1,31 +1,53 @@
 .. include:: /Includes.rst.txt
+
 renderingOptions.templateVariant
 --------------------------------
 
 :aspect:`Option path`
-      prototypes.<prototypeIdentifier>.formElementsDefinition.Form.renderingOptions.templateVariant
+    prototypes.<prototypeIdentifier>.formElementsDefinition.Form.renderingOptions.templateVariant
 
 :aspect:`Data type`
-      array
+    array
 
 :aspect:`Needed by`
-      Frontend
+    Frontend
 
 :aspect:`Overwritable within form definition`
-      Yes
+    Yes
 
 :aspect:`form editor can write this property into the form definition (for prototype 'standard')`
-      No
+    No
 
 :aspect:`Mandatory`
-      No
+    No
 
 :aspect:`Default value (for prototype 'standard')`
+    ..  code-block:: yaml
 
-      .. code-block:: yaml
-
-         templateVariant: version1
+        templateVariant: version1
 
 :aspect:`Description`
-      Set this option to `version2` to use Bootstrap 5 compatible and
-      accessible templates.
+    Set this option to :yaml:`version2` to use Bootstrap 5 compatible and
+    accessible templates.
+
+    ..  deprecated:: 12.0
+        Using the legacy form template / partial variants residing in
+        :file:`EXT:form/Resources/Private/Frontend/Templates` and
+        :file:`EXT:form/Resources/Private/Frontend/Partials` ("version1") is
+        deprecated. The legacy templates will be removed in v13.
+
+        **Migration**: Set your form rendering option :yaml:`templateVariant`
+        within the form setup from :yaml:`version1` to :yaml:`version2` to use
+        the future default templates:
+
+        ..  code-block:: yaml
+
+            prototypes:
+              standard:
+                formElementsDefinition:
+                  Form:
+                    renderingOptions:
+                      templateVariant: version2
+
+        Adjust your templates / partials to make them compatible with the ones
+        stored in :file:`EXT:form/Resources/Private/FrontendVersion2`.