# Move to Trash

Action `arrow.right.doc.on.clipboard`

`action.move_file`

Move or copy a file to a new destination. The source file path comes from the upstream payload (typically `{{filePath}}` from a File Changed trigger). The destination supports interpolation for dynamic paths. Intermediate directories are created automatically when enabled.

Destructive action

This node removes files. The default mode routes through the macOS Trash so deletion is recoverable; toggling `permanent` bypasses the Trash entirely and the file cannot be undone. Workflows containing this node prompt for confirmation on every arm.

## Ports

Direction | Name | Data Type | Description
--- | --- | --- | ---
Input | Input | Any | Payload with source file path
Output | Output | Any | Payload with move/copy result

## Configuration

Field | Type | Default | Description
--- | --- | --- | ---
destination | Text | — | Destination path. Supports `{{var}}` (e.g., `{{userInput}}/{{fileName}}`).
mode | Dropdown | `move` | Operation mode: Move or Copy
overwrite | Boolean | `true` | Overwrite if file already exists at destination
createDirectories | Boolean | `true` | Create intermediate directories if they do not exist

## Output Variables

Variable | Type | Description
--- | --- | ---
sourcePath | String | Original file path
destPath | String | New file path after move/copy
fileName | String | Name of the file
fileSize | Number | File size in bytes

## Example

Sort downloads by file extension: