File Copy Action

The File Copy Action node copies a file from a source path to a destination path.

This node is primarily intended for smaller individual files such as templates, configuration files, or preference files.

For large media files (e.g., video), it is recommended to use the Job File Copy Action executed asynchronously. That method provides transfer progress in the dashboard and is better suited for high-volume media transfers.

Input Parameters

File Path Full path to the source file, including filename and extension.

New File Path Destination path and filename of the copied file.

If New File Exists Defines how the node behaves if the destination file already exists:

  • FAIL β€” stop the node with an error

  • SKIP β€” keep the existing file and do nothing

  • DELETE_EXISTING β€” overwrite the existing file

  • RENAME_EXISTING β€” rename the existing destination file before copying

  • INCREMENT_NAME β€” create a new file with an incremented filename

File Copy Action

Output

After a successful copy, the node result contains the destination file path of the new file.

Behavior

  • Copies a single file

  • Does not move or delete the source file

  • Can apply conflict handling rules

  • Supports asynchronous execution

Typical Use Cases

  • copying project templates

  • distributing configuration or preset files

  • preparing render or export environments

  • transferring small auxiliary files

Practical Note

Use this node for utility files, not for media transfers. If you copy large video files with this node, the stream will remain blocked until the transfer finishes β€” which is exactly what the Job File Copy Action is designed to avoid.

Last updated