diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml
index 026ac2a2975..5a1fd5af140 100644
--- a/doc/classes/Node.xml
+++ b/doc/classes/Node.xml
@@ -521,6 +521,7 @@
 			<argument index="1" name="keep_data" type="bool" default="false" />
 			<description>
 				Replaces a node in a scene by the given one. Subscriptions that pass through this node will be lost.
+				Note that the replaced node is not automatically freed, so you either need to keep it in a variable for later use or free it using [method Object.free].
 			</description>
 		</method>
 		<method name="request_ready">