diff --git a/docs/html/cli/pip_search.rst b/docs/html/cli/pip_search.rst
index 9905a1baf..93ddab3fa 100644
--- a/docs/html/cli/pip_search.rst
+++ b/docs/html/cli/pip_search.rst
@@ -21,6 +21,12 @@ Usage
 Description
 ===========
 
+.. attention::
+    PyPI no longer supports ``pip search`` (or XML-RPC search). Please use https://pypi.org/search (via a browser)
+    instead. See https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods for more information.
+
+    However, XML-RPC search (and this command) may still be supported by indexes other than PyPI.
+
 .. pip-command-description:: search
 
 
diff --git a/news/12059.doc.rst b/news/12059.doc.rst
new file mode 100644
index 000000000..bf3a8d3e6
--- /dev/null
+++ b/news/12059.doc.rst
@@ -0,0 +1 @@
+Document that ``pip search`` support has been removed from PyPI