diff --git a/docs/api/shell.md b/docs/api/shell.md
index 6271ae5b5f9e..8b916e488e1e 100644
--- a/docs/api/shell.md
+++ b/docs/api/shell.md
@@ -46,6 +46,7 @@ application was available to open the URL, false otherwise.
 * `fullPath` String
 
 Move the given file to trash and returns a boolean status for the operation.
+Returns true if the item was successfully moved to the trash, false otherwise.
 
 ### `shell.beep()`