diff --git a/content/manuals/build/builders/_index.md b/content/manuals/build/builders/_index.md
index ccb8d9a6202e..087b61e0f196 100644
--- a/content/manuals/build/builders/_index.md
+++ b/content/manuals/build/builders/_index.md
@@ -99,6 +99,9 @@ To use the `docker build` command with a non-default builder, you must either:
   > [!TIP]
   > To undo this change, run `docker buildx uninstall`.
 
+  > [!WARNING]
+  > The `docker buildx install` and `docker buildx uninstall` commands are deprecated.
+
 <!-- vale Docker.We = NO -->
 
 In general, we recommend that you use the `docker buildx build` command when
diff --git a/data/buildx/docker_buildx_install.yaml b/data/buildx/docker_buildx_install.yaml
index 39072f3cfed6..b06139b0fafa 100644
--- a/data/buildx/docker_buildx_install.yaml
+++ b/data/buildx/docker_buildx_install.yaml
@@ -25,7 +25,7 @@ inherited_options:
       experimentalcli: false
       kubernetes: false
       swarm: false
-deprecated: false
+deprecated: true
 hidden: true
 experimental: false
 experimentalcli: false
diff --git a/data/buildx/docker_buildx_uninstall.yaml b/data/buildx/docker_buildx_uninstall.yaml
index 5b7661324834..5351b82d7377 100644
--- a/data/buildx/docker_buildx_uninstall.yaml
+++ b/data/buildx/docker_buildx_uninstall.yaml
@@ -25,7 +25,7 @@ inherited_options:
       experimentalcli: false
       kubernetes: false
       swarm: false
-deprecated: false
+deprecated: true
 hidden: true
 experimental: false
 experimentalcli: false