diff --git a/website/docs/r/ecr_registry_policy.html.markdown b/website/docs/r/ecr_registry_policy.html.markdown
index 29be6b589d69..c2a6efa233c2 100644
--- a/website/docs/r/ecr_registry_policy.html.markdown
+++ b/website/docs/r/ecr_registry_policy.html.markdown
@@ -10,6 +10,8 @@ description: |-
 
 Provides an Elastic Container Registry Policy.
 
+~> **NOTE on ECR Registry Policies:** While the AWS Management Console interface may suggest the ability to define multiple policies by creating multiple statements, ECR registry policies are effectively managed as singular entities at the regional level by the AWS APIs. Therefore, the `aws_ecr_registry_policy` resource should be configured only once per region with all necessary statements defined in the same policy. Attempting to define multiple `aws_ecr_registry_policy` resources may result in perpetual differences, with one policy overriding another.
+
 ## Example Usage
 
 ```terraform