Folder Move Action
The Folder Move Action node moves a folder from a source location to a destination location.
Unlike a copy operation, the original folder is removed from the source path after the move completes successfully. The node supports conflict-handling rules in case the destination folder already exists.
The operation is executed on the host system running the stream (client or server).
Input Parameters
Folder Path Path and name of the source folder to be moved.
New Folder Path Destination path and name of the moved folder.
If New Folder Exists Defines how the node behaves if the destination folder already exists:
FAIL — stop the node with an error
SKIP — keep the existing destination folder and do nothing
DELETE_EXISTING — delete the destination folder before moving
RENAME_EXISTING — rename the existing destination folder before moving
INCREMENT_NAME — move the folder using an incremented destination name
Behavior
Moves the folder including all files and subfolders
Removes the folder from the source location after a successful move
Applies the configured conflict rule if necessary
Supports asynchronous execution
Typical Use Cases
archiving completed projects
moving deliveries into playout directories
relocating working directories after processing
organizing watchfolder outputs
Important Note
Using DELETE_EXISTING permanently removes the destination folder and its contents before moving the source folder. Use this option carefully.
Practical Tip
If you want to ensure the destination folder name is always unique (instead of overwriting or skipping), combine this node with the Folder Increment Name Action to generate a safe destination path first.
Last updated