diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
index 794a404e2b504..52cfaff9c9ced 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
@@ -2,7 +2,7 @@
   "cat.indices": {
     "documentation": {
       "url": "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cat-indices",
-      "description": "Get index information"
+      "description": "Get index information. Document counts come directly from Lucene, so they include hidden nested documents (for example, those created by semantic_text fields). Use the cat count or count APIs to retrieve the top-level Elasticsearch document count."
     },
     "stability": "stable",
     "visibility": "public",