diff --git a/content/developer/reference/backend/orm.rst b/content/developer/reference/backend/orm.rst
index af40454ca..b5328c724 100644
--- a/content/developer/reference/backend/orm.rst
+++ b/content/developer/reference/backend/orm.rst
@@ -693,6 +693,7 @@ Useful environment methods
 .. automethod:: Environment.is_superuser
 .. automethod:: Environment.is_admin
 .. automethod:: Environment.is_system
+.. automethod:: Environment.execute_query
 
 Altering the environment
 ------------------------
diff --git a/content/developer/reference/backend/orm/changelog.rst b/content/developer/reference/backend/orm/changelog.rst
index 66ebd3b55..43ae1ae0d 100644
--- a/content/developer/reference/backend/orm/changelog.rst
+++ b/content/developer/reference/backend/orm/changelog.rst
@@ -4,6 +4,17 @@
 Changelog
 =========
 
+Odoo Online version 17.1
+========================
+
+- Method :meth:`~odoo.models.Model._flush_search` has been deprecated with
+  `#144747 <https://github.com/odoo/odoo/pull/144747>`_.
+  The flushing of fields is now done by :meth:`~odoo.api.Environment.execute_query`,
+  and is based on metadata put in the :class:`~odoo.tools.SQL` object by
+  :meth:`~odoo.models.BaseModel._search` and other low-level ORM methods that
+  build such objects.  Those methods are also responsible for checking the access
+  rights on the fields that are used in the SQL object.
+
 Odoo version 17.0
 =================