diff --git a/docs/content/maintenance/manage-branches.md b/docs/content/maintenance/manage-branches.md
index 2da92056a829..7b18583709c7 100644
--- a/docs/content/maintenance/manage-branches.md
+++ b/docs/content/maintenance/manage-branches.md
@@ -87,6 +87,10 @@ CALL sys.create_branch('default.T', 'empty_branch');
 
 You can delete branch by its name.
 
+{{< hint warning >}}
+__Note:__ The `Delete Branches` operation only deletes the metadata file. If you want to clear the data written during the branch, use [remove_orphan_files]({{< ref "flink/procedures" >}})
+{{< /hint >}}
+
 {{< tabs "delete-branches" >}}
 
 {{< tab "Flink SQL" >}}