diff --git a/docs/index.md b/docs/index.md
index 45b7c8a5..7caa36cd 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -12,6 +12,8 @@ description: |-
   If you are upgrading, please be sure to not skip any major release while you do so.
   For example:
   0.3.0 to 1.0.0 is a valid upgrade path0.3.0 to 1.1.0 is a valid upgrade path0.3.0 to 2.0.0 is NOT a valid upgrade path
+  Upgrading to version >= 3.2.0 of the Clickhouse Terraform Provider
+  In version 3.2.0, we introduced a change to the Private Endpoints feature that requires an update on your end. If you are using the clickhouse_private_endpoint_registration resource, this affects you. Please visit https://github.com/ClickHouse/terraform-provider-clickhouse#breaking-changes-and-deprecations https://github.com/ClickHouse/terraform-provider-clickhouse#breaking-changes-and-deprecations for more details.
   Upgrading to version >= 3.0.0 of the Clickhouse Terraform Provider
   In version 3.0.0 we revisited how to deal with clickhouse_service endpoints.
   If you are using the endpoint_config attribute or the endpoints read only attribute, this breaking change affects you.
@@ -44,6 +46,10 @@ For example:
 - `0.3.0` to `1.1.0` is a valid upgrade path
 - `0.3.0` to `2.0.0` is NOT a valid upgrade path
 
+### Upgrading to version >= 3.2.0 of the Clickhouse Terraform Provider
+
+In version 3.2.0, we introduced a change to the `Private Endpoints` feature that requires an update on your end. If you are using the `clickhouse_private_endpoint_registration` resource, this affects you. Please visit [https://github.com/ClickHouse/terraform-provider-clickhouse#breaking-changes-and-deprecations](https://github.com/ClickHouse/terraform-provider-clickhouse#breaking-changes-and-deprecations) for more details.
+
 ### Upgrading to version >= 3.0.0 of the Clickhouse Terraform Provider
 
 In version 3.0.0 we revisited how to deal with `clickhouse_service` endpoints.
diff --git a/pkg/provider/README.md b/pkg/provider/README.md
index 2913a194..d4f23a22 100644
--- a/pkg/provider/README.md
+++ b/pkg/provider/README.md
@@ -19,6 +19,10 @@ For example:
 - `0.3.0` to `1.1.0` is a valid upgrade path
 - `0.3.0` to `2.0.0` is NOT a valid upgrade path
 
+### Upgrading to version >= 3.2.0 of the Clickhouse Terraform Provider
+
+In version 3.2.0, we introduced a change to the `Private Endpoints` feature that requires an update on your end. If you are using the `clickhouse_private_endpoint_registration` resource, this affects you. Please visit [https://github.com/ClickHouse/terraform-provider-clickhouse#breaking-changes-and-deprecations](https://github.com/ClickHouse/terraform-provider-clickhouse#breaking-changes-and-deprecations) for more details.
+
 ### Upgrading to version >= 3.0.0 of the Clickhouse Terraform Provider
 
 In version 3.0.0 we revisited how to deal with `clickhouse_service` endpoints.