Add doc section

Author: squrious

src/LiveComponent/doc/index.rst

@@ -2341,11 +2341,6 @@ If you load this URL in your browser, the ``LiveProp`` value will be initialized
 
     The URL is changed via ``history.replaceState()``. So no new entry is added.
 
-.. warning::
-
-    You can use multiple components with URL bindings in the same page, as long as bound field names don't collide.
-    Otherwise, you will observe unexpected behaviors.
-
 Supported Data Types
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -2389,6 +2384,50 @@ For example, if you declare the following bindings::
 And you only set the ``query`` value, then your URL will be updated to
 ``https://my.domain/search?query=my+query+string&mode=fulltext``.
 
+Controlling the Query Parameter Name
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Instead of using the prop's field name as the query parameter name, you can use the ``as`` option in your ``LiveProp``
+definition::
+
+    // ...
+    use Symfony\UX\LiveComponent\Metadata\UrlMapping;
+
+    #[AsLiveComponent]
+    class SearchModule
+    {
+        #[LiveProp(writable: true, url: new UrlMapping(as: 'q')]
+        public string $query = '';
+
+        // ...
+    }
+
+Then the ``query`` value will appear in the URL like ``https://my.domain/search?q=my+query+string``.
+
+If you need to use a custom parameter name on a specific page, you can override the mapping on a per-template basis:
+
+.. code-block:: html+twig
+
+    {# Pass a mapping object #}
+    <twig:SearchModule :data-live-url-mapping-query="{ alias: 'q'}" />
+
+    {# Or configure the mapping option directly #}
+    <twig:SearchModule data-live-url-mapping-query-alias="q" />
+
+This way you can also use the component multiple times in the same page and avoid collisions with parameter names:
+
+.. code-block:: html+twig
+
+    {# First search module using 'q1' parameter #}
+    <twig:SearchModule data-live-url-mapping-query-alias="q1" />
+
+    {# Second search module using 'q2' parameter #}
+    <twig:SearchModule data-live-url-mapping-query-alias="q2" />
+
+.. note::
+
+    You can configure the mapping in templates only if the ``url`` option is enabled in the ``#LiveProp`` attribute.
+
 Validating the Query Parameter Values
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~