diff --git a/docs/resources/env.md b/docs/resources/env.md
index 5c68f08e..b948bad9 100644
--- a/docs/resources/env.md
+++ b/docs/resources/env.md
@@ -3,12 +3,12 @@
 page_title: "coder_env Resource - terraform-provider-coder"
 subcategory: ""
 description: |-
-  Use this resource to set an environment variable in a workspace.
+  Use this resource to set an environment variable in a workspace. Note that this resource cannot be used to overwrite existing environment variables set on the "coder_agent" resource.
 ---
 
 # coder_env (Resource)
 
-Use this resource to set an environment variable in a workspace.
+Use this resource to set an environment variable in a workspace. Note that this resource cannot be used to overwrite existing environment variables set on the "coder_agent" resource.
 
 
 
diff --git a/provider/env.go b/provider/env.go
index f71ae987..66d03a22 100644
--- a/provider/env.go
+++ b/provider/env.go
@@ -12,7 +12,7 @@ import (
 
 func envResource() *schema.Resource {
 	return &schema.Resource{
-		Description: "Use this resource to set an environment variable in a workspace.",
+		Description: `Use this resource to set an environment variable in a workspace. Note that this resource cannot be used to overwrite existing environment variables set on the "coder_agent" resource.`,
 		CreateContext: func(_ context.Context, rd *schema.ResourceData, _ interface{}) diag.Diagnostics {
 			rd.SetId(uuid.NewString())