symfony
diff --git a/‎http_client.rst
Lines changed: 17 additions & 11 deletions b/‎http_client.rst
Lines changed: 17 additions & 11 deletions
@@ -116,7 +116,7 @@ You can configure the global options using the ``default_options`` option:
             <framework:config>
                 <framework:http-client>
                     <framework:default-options max-redirects="7"/>
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
@@ -176,7 +176,7 @@ The HTTP client also has one configuration option called
             <framework:config>
                 <framework:http-client max-host-connections="10">
                     <!-- ... -->
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
@@ -495,8 +495,7 @@ associative array via the ``query`` option, that will be merged with the URL::
 Headers
 ~~~~~~~
 
-Use the ``headers`` option to define both the default headers added to all
-requests and the specific headers for each request:
+Use the ``headers`` option to define the default headers added to all requests:
 
 .. configuration-block::
 
@@ -505,8 +504,9 @@ requests and the specific headers for each request:
         # config/packages/framework.yaml
         framework:
             http_client:
-                headers:
-                    'User-Agent': 'My Fancy App'
+                default_options:
+                    headers:
+                        'User-Agent': 'My Fancy App'
 
     .. code-block:: xml
 
@@ -521,8 +521,10 @@ requests and the specific headers for each request:
 
             <framework:config>
                 <framework:http-client>
-                    <framework:header name="User-Agent">My Fancy App</framework:header>
-                </framework-http-client>
+                    <framework:default-options>
+                        <framework:header name="User-Agent">My Fancy App</framework:header>
+                    </framework:default-options>
+                </framework:http-client>
             </framework:config>
         </container>
 
@@ -531,8 +533,10 @@ requests and the specific headers for each request:
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
             'http_client' => [
-                'headers' => [
-                    'User-Agent' => 'My Fancy App',
+                'default_options' => [
+                    'headers' => [
+                        'User-Agent' => 'My Fancy App',
+                    ],
                 ],
             ],
         ]);
@@ -546,6 +550,8 @@ requests and the specific headers for each request:
             ],
         ]);
 
+You can also set new headers or override the default ones for specific requests:
+
 .. code-block:: php
 
     // this header is only included in this request and overrides the value
@@ -865,7 +871,7 @@ To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
             <framework:config>
                 <framework:http-client>
                     <framework:default-options http-version="2.0"/>
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>