diff --git a/README.md b/README.md
index 12c905f36..11d6ca555 100644
--- a/README.md
+++ b/README.md
@@ -2356,6 +2356,13 @@ For built-in RabbitMQ `bitnami/rabbitmq` subchart, pre-upgrade hook was added to
 
 ### To 2-9-0
 
+> [!WARNING]
+> **BREAKING CHANGES**
+>
+> Default DinD image has been upgraded to 28.x, which removes support for pushing and pulling with legacy image manifest v2 schema 1 ([ref](https://docs.docker.com/engine/deprecated/#pushing-and-pulling-with-image-manifest-v2-schema-1)).
+>
+> Before upgrading Codefresh, please follow the instruction in [this doc](https://codefresh.io/docs/docs/kb/articles/upgrade-deprecated-docker-images/) to identify deprecated images, upgrade them, and then proceed with upgrading the platform.
+
 ####  Affected values
 
 - `.Values.runner` is removed
diff --git a/README.md.gotmpl b/README.md.gotmpl
index 013502286..409467e3f 100644
--- a/README.md.gotmpl
+++ b/README.md.gotmpl
@@ -2366,6 +2366,13 @@ For built-in RabbitMQ `bitnami/rabbitmq` subchart, pre-upgrade hook was added to
 
 ### To 2-9-0
 
+> [!WARNING]
+> **BREAKING CHANGES**
+> 
+> Default DinD image has been upgraded to 28.x, which removes support for pushing and pulling with legacy image manifest v2 schema 1 ([ref](https://docs.docker.com/engine/deprecated/#pushing-and-pulling-with-image-manifest-v2-schema-1)).
+>
+> Before upgrading Codefresh, please follow the instruction in [this doc](https://codefresh.io/docs/docs/kb/articles/upgrade-deprecated-docker-images/) to identify deprecated images, upgrade them, and then proceed with upgrading the platform.
+
 ####  Affected values
 
 - `.Values.runner` is removed