diff --git a/src/langsmith/kubernetes.mdx b/src/langsmith/kubernetes.mdx
index c5639eadf9..279570db70 100644
--- a/src/langsmith/kubernetes.mdx
+++ b/src/langsmith/kubernetes.mdx
@@ -128,6 +128,12 @@ For more information, refer to the following setup guides for external services:
    2. If you are new to Kubernetes or Helm, we’d recommend starting with one of the example configurations in the examples directory of the Helm Chart repository here: [LangSmith helm chart examples](https://github.com/langchain-ai/helm/tree/main/charts/langsmith/examples).
    3. You can see a full list of configuration options in the `values.yaml` file in the Helm Chart repository here: [LangSmith Helm Chart](https://github.com/langchain-ai/helm/tree/main/charts/langsmith/values.yaml)
 
+<Warning>
+  Only override the settings you need in `langsmith_config.yaml`; don’t copy the entire `values.yaml`. 
+  Keeping your config minimal ensures you continue to inherit new defaults and upgrades from the Helm chart.
+</Warning>
+
+
 2. At a minimum, you will need to set the following configuration options (using basic auth):
 
    ```yaml