---
title: "writefile"
description: "Creates or overwrites a file and creates missing parent directories."
---

```lua
writefile(path: string, data: string): ()
```

---

## Aliases

None.

---

## Arguments

<ParamField body="path" type="string" required>
  A UTF-8 path relative to the Byte workspace.
</ParamField>

<ParamField body="data" type="string" required>
  The input bytes as a binary-safe Luau string.
</ParamField>

---

## Returns

This function returns no values.

Blocked extensions raise Unsafe function. Existing content is replaced.

**Related types:** [Filesystem types & behavior](/reference/filesystem/types).

---

## Example

```lua
writefile("docs-example/settings.json", [[{"enabled":true}]])
```