Skip to content

Scrapy, a fast high-level web crawling & scraping framework for Python.

Add mention to dont_merge_cookies in CookiesMiddlewares docs (#2999) (#3030)

Raphaela1cc5a63d3e2
diff --git a/docs/topics/downloader-middleware.rst b/docs/topics/downloader-middleware.rst
index 983a93290..863620900 100644
--- a/docs/topics/downloader-middleware.rst
+++ b/docs/topics/downloader-middleware.rst
@@ -237,6 +237,17 @@ Default: ``True``
Whether to enable the cookies middleware. If disabled, no cookies will be sent
to web servers.
+Notice that if the :class:`~scrapy.http.Request`
+has ``meta['dont_merge_cookies']`` evaluated to ``True``.
+despite the value of :setting:`COOKIES_ENABLED` the cookies will **not** be
+sent to web servers and received cookies in
+:class:`~scrapy.http.Response` will **not** be merged with the existing
+cookies.
+
+For more detailed information see the ``cookies`` parameter in
+:class:`~scrapy.http.Request`
+
+
.. setting:: COOKIES_DEBUG
COOKIES_DEBUG