diff --git a/api/envoy/extensions/filters/http/on_demand/v3/on_demand.proto b/api/envoy/extensions/filters/http/on_demand/v3/on_demand.proto
index 791c73b880a02..93c9f76f8317c 100644
--- a/api/envoy/extensions/filters/http/on_demand/v3/on_demand.proto
+++ b/api/envoy/extensions/filters/http/on_demand/v3/on_demand.proto
@@ -19,6 +19,11 @@ option (udpa.annotations.file_status).package_version_status = ACTIVE;
 // [#protodoc-title: On Demand Discovery]
 // On Demand Discovery :ref:`configuration overview <config_http_filters_on_demand>`.
 // [#extension: envoy.filters.http.on_demand]
+//
+// .. warning::
+//
+//    Envoy currently only supports On-demand CDS when using Incremental-xDS and not State-of-the-World.
+//
 
 // Configuration of on-demand CDS.
 message OnDemandCds {