diff --git a/d/google_iam_policy.html.markdown b/d/google_iam_policy.html.markdown
index 01d94012..81be62a1 100644
--- a/d/google_iam_policy.html.markdown
+++ b/d/google_iam_policy.html.markdown
@@ -33,6 +33,10 @@ This data source is used to define IAM policies to apply to other resources.
 Currently, defining a policy through a datasource and referencing that policy
 from another resource is the only way to apply an IAM policy to a resource.
 
+**Note:** Several restrictions apply when setting IAM policies through this API.
+See the [setIamPolicy docs](https://cloud.google.com/resource-manager/reference/rest/v1/projects/setIamPolicy)
+for a list of these restrictions.
+
 ## Argument Reference
 
 The following arguments are supported: