diff --git a/docs/resources/connection.md b/docs/resources/connection.md
index 00087d77..786eeeae 100644
--- a/docs/resources/connection.md
+++ b/docs/resources/connection.md
@@ -11,6 +11,7 @@ With Auth0, you can define sources of users, otherwise known as connections, whi
 ~> The Auth0 dashboard displays only one connection per social provider. Although the Auth0 Management API allows the
 creation of multiple connections per strategy, the additional connections may not be visible in the Auth0 dashboard.
 
+~> When updating the `options` parameter, ensure that all nested fields within the `options` schema are explicitly defined. Failing to do so may result in the loss of existing configurations.
 
 ## Example Usage
 
diff --git a/templates/resources/connection.md.tmpl b/templates/resources/connection.md.tmpl
index 78e4f5e3..ea5d3134 100644
--- a/templates/resources/connection.md.tmpl
+++ b/templates/resources/connection.md.tmpl
@@ -11,6 +11,7 @@ description: |-
 ~> The Auth0 dashboard displays only one connection per social provider. Although the Auth0 Management API allows the
 creation of multiple connections per strategy, the additional connections may not be visible in the Auth0 dashboard.
 
+~> When updating the `options` parameter, ensure that all nested fields within the `options` schema are explicitly defined. Failing to do so may result in the loss of existing configurations.
 
 {{ if .HasExample -}}