diff --git a/messenger.rst b/messenger.rst
index 605561e39d5..56ef5af1382 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -753,8 +753,8 @@ reset the service container between two messages:
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:messenger>
-                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%" reset-on-message="true">
+                <framework:messenger reset-on-message="true">
+                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
                     </framework:transport>
                 </framework:messenger>
             </framework:config>
@@ -775,6 +775,12 @@ reset the service container between two messages:
 
     The ``reset_on_message`` option was introduced in Symfony 5.4.
 
+.. note::
+
+    ``reset_on_message`` will default to true (with no other allowed value) in
+    Symfony 6. To disable this behavior, execute the ``messenger:consume``
+    command with the ``--no-reset`` option.
+
 .. _messenger-retries-failures:
 
 Retries & Failures