> 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/job-action/job-folder-copy-action.md).

# Job Folder Copy Action

The **Job Folder Copy Action** node copies a folder while providing progress feedback in the Helmut dashboard.

This node is designed for large directory transfers such as media folders or project directories. Unlike the standard [Folder Copy Action](/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/file-and-folder-22/folder-copy-action.md), it integrates with the job system and can display status messages during the operation.

#### Input Parameters

**Folder Path**\
Path and name of the source folder to be copied.\
Wildcards (e.g., [{job.source}](/helmut4-releases/helmut4-components/streamdesigner/wildcards/job-related-wildcards-32/job-source.md)) may be used.

**New Folder Path**\
Destination path and name of the copied folder.

**Copy Message**\
Message displayed in the dashboard while the copy process is running.

**Copy Done Message**\
Message displayed after the copy operation has completed successfully.

**If New Folder Path Exists**\
Defines how the node behaves if the destination folder already exists:

* **FAIL** — stop the node with an error
* **SKIP** — keep the existing folder and do nothing
* **DELETE\_EXISTING** — delete the destination folder before copying
* **RENAME\_EXISTING** — rename the existing folder before copying
* **MERGE\_WITH\_EXISTING** — merge contents into the existing folder
* **INCREMENT\_NAME** — create a new folder with an incremented name

<figure><img src="/files/Kw6ISqTDv6xoENDugSIb" alt="" width="375"><figcaption><p>Job Folder Copy Action</p></figcaption></figure>

#### Output

The node result contains the destination path of the copied folder.

#### Behavior

* Copies folders recursively
* Displays progress information in the dashboard
* Designed for long-running copy operations
* Integrates with job-based workflows
* Empty sub-folders will also be copied

#### Typical Use Cases

* transferring camera card structures
* moving large media packages
* ingesting project directories
* backup or archive workflows

#### Practical Note

Use this node whenever users need visibility into long transfers.\
If you copy large folders with the standard Folder Copy Action, the stream will appear frozen until the operation finishes — this node prevents that by reporting progress.


---

# 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/job-action/job-folder-copy-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.