> 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-increment-name-action.md).

# File Increment Name Action

The **File Increment Name Action** node generates a new filename by incrementing the provided file name if a file with the same name already exists.

The node checks the specified file path and increases the filename by appending a number until a non-existing filename is found. No file is created or modified during this process — the node only returns the next available filename.

The resulting file path can then be used by subsequent nodes.

#### Input Parameters

**File Path**\
Full file path (including filename and extension) that should be checked and incremented if necessary.

<figure><img src="/files/HA2UxU1LwRYlPycyUFRv" alt=""><figcaption></figcaption></figure>

#### Output and Wildcards

The resulting filename (including full path) is returned and can be accessed using:

* [{stream.last\_result}](/helmut4-releases/helmut4-components/streamdesigner/wildcards/result-or-return-wildcards-2/stream-last_result.md)
* [{node.result.?}](/helmut4-releases/helmut4-components/streamdesigner/wildcards/result-or-return-wildcards-2/node-result.md)

#### Behavior

* Checks whether the specified file already exists
* If it exists, increments the filename (e.g., `file.txt` → `file_1.txt` → `file_2.txt`, etc.)
* Returns the first available filename
* Does not create or modify any file
* Supports asynchronous execution

#### Typical Use Cases

* preparing export destinations
* preventing overwriting of existing files
* automated render or delivery workflows
* creating versioned output files

#### Practical Note

Use this node when you want to ensure a process continues even if a target filename already exists.\
Instead of overwriting a file or stopping the workflow, the stream automatically receives a safe, unused filename for the next operation (such as a copy, render, or export).


---

# 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-increment-name-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.