> For the complete documentation index, see [llms.txt](https://docs.helmut.de/helmut4-releases/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/file-and-folder-22/folder-move-action.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.