Sends a file or directory to the recycle bin if possible, or permanently deletes it.

FileRecycle, FilePattern



The name of a single file or a wildcard pattern such as C:\Temp\*.tmp. FilePattern is assumed to be in %A_WorkingDir% if an absolute path isn't specified.

To recycle an entire directory, provide its name without a trailing backslash.

Error Handling

[v1.1.04+]: This command is able to throw an exception on failure. For more information, see Runtime Errors.

ErrorLevel is set to 1 if there was a problem or 0 otherwise.


SHFileOperation is used to do the actual work. This function may permanently delete the file if it is too large to be recycled; as of [v1.0.96], a warning should be shown before this occurs.

The file may be permanently deleted without warning if the file cannot be recycled for other reasons, such as:

FileRecycleEmpty, FileDelete, FileCopy, FileMove


Sends all .tmp files in a directory to the recycle bin if possible.

FileRecycle, C:\temp files\*.tmp