diff --git a/docs/src/main/sphinx/admin/spill.md b/docs/src/main/sphinx/admin/spill.md
index cd1c190c8f73..10d7f2333405 100644
--- a/docs/src/main/sphinx/admin/spill.md
+++ b/docs/src/main/sphinx/admin/spill.md
@@ -12,6 +12,12 @@ implemented on the application level to address specific needs of Trino.
 
 Properties related to spilling are described in {doc}`properties-spilling`.
 
+:::{warning} 
+The spill to disk feature and implementation are a legacy functionality of
+Trino. Consider using [](/admin/fault-tolerant-execution) with the `task` retry
+policy and a configured [](fte-exchange-manager).
+:::
+
 ## Memory management and spill
 
 By default, Trino kills queries, if the memory requested by the query execution