# 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

<figure><img src="/files/JsKkJNWSROid7GxjUOwx" alt="" width="352"><figcaption><p>Folder Move Action</p></figcaption></figure>

#### 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](/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/file-and-folder-22/folder-increment-name-action.md) to generate a safe destination path first.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/file-and-folder-22/folder-move-action.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.