> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sndbox.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Write File

> Write text to an approved file. Exact configuration, ports, placement, and execution behavior.

**Node type:** `write_file` · **Version:** `1` · **Category:** System

Write text to an approved file. This node can change external state or produce an external side effect.

## Configuration

| Field           | Type    | Default | What it controls                                                                                     |
| --------------- | ------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `path`          | path    | `""`    | Approved local file or folder path.                                                                  |
| `content`       | string  | `""`    | Literal or mapped content. For parser nodes, mapped content takes precedence over the optional file. |
| `overwrite`     | boolean | `false` | Allow replacement when the destination already exists.                                               |
| `createParents` | boolean | `false` | Create missing parent folders before writing.                                                        |

## Workflow JSON

The editor stores this node with the following implemented default configuration:

```json title="Default node configuration" theme={"system"}
{
  "type": "write_file",
  "version": 1,
  "configuration": {
    "path": "",
    "content": "",
    "overwrite": false,
    "createParents": false
  }
}
```

Values may be entered literally or mapped from an earlier compatible output when the inspector exposes a mapping control. See [Variables and data mapping](/workflows/variables-and-data).

## Inputs

| Port      | Type     | Required | Description |
| --------- | -------- | -------- | ----------- |
| `path`    | `path`   | Yes      | File path   |
| `content` | `string` | Yes      | Content     |

## Outputs

| Port    | Type     | Required | Description |
| ------- | -------- | -------- | ----------- |
| `path`  | `path`   | No       | Path        |
| `bytes` | `number` | No       | Bytes       |

## Where it can run

* Desktop local runner
* Paired self-hosted runner
* Hosted runner

## Test and inspect

Use **Test node** in the editor to preview this step with the current configuration. A full run records resolved inputs, outputs, logs, duration, and any artifacts in the execution inspector. Side-effecting or destructive nodes can require an additional confirmation or approved workflow permission.