diff --git a/docs/upgrading_to_v9.0.0.md b/docs/upgrading_to_v9.0.0.md
new file mode 100644
index 000000000..9508f8943
--- /dev/null
+++ b/docs/upgrading_to_v9.0.0.md
@@ -0,0 +1,5 @@
+# Upgrading to v9.0.0
+
+The v9.0 release contains backwards-incompatible changes.
+
+This update requires upgrading the minimum provider version of `hashicorp/google` from `3.50` to `5.8` and `hashicorp/google-beta` from `3.50` to `5.8`.