> 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/file-move-action.md).

# File Move Action

The **File Move Action** node moves a file from a source path to a destination path.

Unlike the [File Copy Action](/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/file-and-folder-22/file-copy-action.md), the original file is removed from the source location after the operation is completed.

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](/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/job-action/job-file-copy-action.md) 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 moved 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 destination file and do nothing
* **DELETE\_EXISTING** — overwrite the existing destination file
* **RENAME\_EXISTING** — rename the existing destination file before moving
* **INCREMENT\_NAME** — move the file using an incremented filename

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

#### Behavior

* Moves a single file
* Removes the source file after a successful move
* Applies conflict handling rules if necessary
* Supports asynchronous execution

#### Typical Use Cases

* moving generated files into delivery folders
* organizing workflow outputs
* relocating configuration or template files
* post-processing cleanup

#### Practical Note

This node performs a real move operation, not a copy-and-delete simulation inside the workflow.\
After execution, the original file no longer exists at the source location, so ensure the destination path is correct before running the stream.


---

# 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/file-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.