diff --git a/output/schema/schema.json b/output/schema/schema.json
index 31335d32ac..e981fbdcf9 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -18926,7 +18926,7 @@
           "stability": "stable"
         }
       },
-      "description": "Performs an update on every document in the index without changing the source,\nfor example to pick up a mapping change.",
+      "description": "Updates documents that match the specified query. If no query is specified,\n performs an update on every document in the index without changing the source,\nfor example to pick up a mapping change.",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-update-by-query.html",
       "name": "update_by_query",
       "request": {
diff --git a/specification/_json_spec/update_by_query.json b/specification/_json_spec/update_by_query.json
index 3856c4249a..b6068132ae 100644
--- a/specification/_json_spec/update_by_query.json
+++ b/specification/_json_spec/update_by_query.json
@@ -2,7 +2,7 @@
   "update_by_query": {
     "documentation": {
       "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-update-by-query.html",
-      "description": "Performs an update on every document in the index without changing the source,\nfor example to pick up a mapping change."
+      "description": "Updates documents that match the specified query. If no query is specified,\n performs an update on every document in the index without changing the source,\nfor example to pick up a mapping change."
     },
     "stability": "stable",
     "visibility": "public",