diff --git a/form/form_customization.rst b/form/form_customization.rst
index 1ed087a32d6..ec92c3fd1ff 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -336,6 +336,38 @@ name of all the templates as an array using the ``with`` keyword:
The templates can also be located in different bundles, use the Twig namespaced
path to reference these templates, e.g. ``@AcmeFormExtra/form/fields.html.twig``.
+Disabling usage of globally defined themes
+..........................................
+
+Sometimes it is useful to disable usage of globally defined form themes in order
+to have more control over rendering of a form. You might want this, for example,
+when creating admin interface for a bundle which can be installed on a wide range
+of Symfony apps and you can't control what themes are defined globally.
+
+You can do this by including the ``only`` keyword after the list of used form
+themes:
+
+.. code-block:: html+twig
+
+ {% form_theme form with ['common.html.twig', 'form/fields.html.twig'] only %}
+
+ {# ... #}
+
+.. caution::
+
+ When using the ``only`` keyword, none of Symfony's built-in form themes
+ (``form_div_layout.html.twig``, etc.) will be applied. In order to render
+ your forms correctly, you need to either provide a full-featured form theme
+ yourself, or extend one of the built-in form themes with Twig's ``use``
+ keyword instead of ``extends`` to reuse the original theme contents.
+
+ .. code-block:: html+twig
+
+ {# app/Resources/views/common.html.twig #}
+ {% use "form_div_layout.html.twig" %}
+
+ {# ... #}
+
Child Forms
...........
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy