diff --git a/content/en/docs/17.0/reference/vreplication/vdiffv1.md b/content/en/docs/17.0/reference/vreplication/vdiffv1.md
index a18843d0b..f61f6bbc9 100644
--- a/content/en/docs/17.0/reference/vreplication/vdiffv1.md
+++ b/content/en/docs/17.0/reference/vreplication/vdiffv1.md
@@ -4,9 +4,9 @@ description: Compare the source and target in a workflow to ensure integrity
 weight: 40
 ---
 
-{{< info >}}
-This is the legacy v1 VDiff. [VDiff v2](../vdiff/), which runs on tablets, is now production-ready. We recommend that you begin using v2 instead.
-{{< /info >}} 
+{{< warning >}}
+This is the legacy v1 VDiff command — it is deprecated in Vitess 18.0 and will be **removed** in 19.0. Please migrate all of your VDiff usage to the new [VDiff](../vdiff/) command before upgrading.
+{{< /warning >}}
 
 ### Command
 
diff --git a/content/en/docs/18.0/reference/vreplication/vdiffv1.md b/content/en/docs/18.0/reference/vreplication/vdiffv1.md
index a18843d0b..6253c1991 100644
--- a/content/en/docs/18.0/reference/vreplication/vdiffv1.md
+++ b/content/en/docs/18.0/reference/vreplication/vdiffv1.md
@@ -4,9 +4,9 @@ description: Compare the source and target in a workflow to ensure integrity
 weight: 40
 ---
 
-{{< info >}}
-This is the legacy v1 VDiff. [VDiff v2](../vdiff/), which runs on tablets, is now production-ready. We recommend that you begin using v2 instead.
-{{< /info >}} 
+{{< warning >}}
+This is the legacy v1 VDiff command — it is deprecated in Vitess 18.0 and will be **removed** in 19.0. Please migrate all of your VDiff usage to the new [VDiff](../vdiff/) command before upgrading.
+{{< /warning >}} 
 
 ### Command
 
diff --git a/content/en/docs/19.0/reference/vreplication/vdiffv1.md b/content/en/docs/19.0/reference/vreplication/vdiffv1.md
index a18843d0b..74cfaed9b 100644
--- a/content/en/docs/19.0/reference/vreplication/vdiffv1.md
+++ b/content/en/docs/19.0/reference/vreplication/vdiffv1.md
@@ -4,9 +4,9 @@ description: Compare the source and target in a workflow to ensure integrity
 weight: 40
 ---
 
-{{< info >}}
-This is the legacy v1 VDiff. [VDiff v2](../vdiff/), which runs on tablets, is now production-ready. We recommend that you begin using v2 instead.
-{{< /info >}} 
+{{< warning >}}
+This is the legacy v1 VDiff command — it was deprecated in Vitess 18.0 and will be **removed** in 19.0. Please migrate all of your VDiff usage to the new [VDiff](../vdiff/) command before upgrading.
+{{< /warning >}}
 
 ### Command