diff --git a/src/Map/doc/index.rst b/src/Map/doc/index.rst
index e3788243291..a90b9400a57 100644
--- a/src/Map/doc/index.rst
+++ b/src/Map/doc/index.rst
@@ -124,11 +124,12 @@ To render a map in your Twig template, use the ``ux_map`` Twig function, e.g.:
 
 .. code-block:: twig
 
-    {{ ux_map(my_map) }}
-    
-    {# or with custom attributes #}
+    {# to be visible, the map must have a defined height #}
     {{ ux_map(my_map, { style: 'height: 300px' }) }}
 
+    {# you can add custom HTML attributes too #}
+    {{ ux_map(my_map, { style: 'height: 300px', id: 'events-map', class: 'mb-3' }) }}
+
 Extend the default behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~