diff --git a/deploy-manage/deploy/cloud-on-k8s/node-configuration.md b/deploy-manage/deploy/cloud-on-k8s/node-configuration.md
index ddd7e5064c..11262c3881 100644
--- a/deploy-manage/deploy/cloud-on-k8s/node-configuration.md
+++ b/deploy-manage/deploy/cloud-on-k8s/node-configuration.md
@@ -34,5 +34,19 @@ spec:
       node.roles: ["data", "ingest", "ml", "transform"]
 ```
 
+::::{warning} 
+ECK parses Elasticsearch configuration and normalizes it to YAML. Consequently, some Elasticsearch configuration schema are impossible to express with ECK and, therefore, must be set using [dynamic cluster settings](/deploy-manage/deploy/self-managed/configure-elasticsearch.md#cluster-setting-types). For example:
+```yaml
+spec:
+  nodeSets:
+  - name: data
+    # ...
+    config:
+      cluster.max_shards_per_node: 1000
+      cluster.max_shards_per_node.frozen: 1000 # This won't work because cluster.max_shards_per_node is defined as a scalar value on the previous line
+    # ...
+```
+::::
+
 For more information on Elasticsearch settings, check [Configuring Elasticsearch](/deploy-manage/deploy/self-managed/configure-elasticsearch.md).