diff --git a/README.md b/README.md
index e735838c1f..155dc9021b 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,10 @@
 - [Getting started with Cloudflare and Terraform](https://developers.cloudflare.com/terraform/installing)
 - [Developing the provider](contributing/development.md)
 
+## Minimum requirements
+
+- Terraform 1.2 or newer. We recommend running the [latest version](https://developer.hashicorp.com/terraform/downloads?product_intent=terraform) for optimal compatibility with the Cloudflare provider. Terraform versions older than 1.2 have known issues with newer features and internals.
+
 ## Documentation
 
 Full, comprehensive documentation is available on the [Terraform Registry](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs). [API documentation](https://api.cloudflare.com) and [Developer documentation](https://developers.cloudflare.com) is also available