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