# Array flat

Returns a new array with all sub-array elements concatenated into it recursively up to the specified depth. Array flat lives in the **Array** category of the `fx` menu.

## Parameters

| Parameter | Type   | Required | Default | Description                                            |
| --------- | ------ | -------- | ------- | ------------------------------------------------------ |
| Input     | string | yes      | —       | Value to transform. Previous step output or a literal. |
| Depth     | number | no       | `1`     | The maximum recursion depth                            |

`Input` is the primary value (previous step output or a literal).

## Returned value

| Type     | Description                              |
| -------- | ---------------------------------------- |
| `string` | Result of the Array flat transformation. |

## Limitations

- Array arguments must be valid JSON arrays. Invalid JSON or non-array values raise an error.

## Example

<details>
<summary>Run Array flat</summary>

Returns a new array with all sub-array elements concatenated into it recursively up to the specified depth. Adjust optional parameters when the defaults do not match your payload.

1. Set **Input** to the value to transform (previous step output or a literal).

2. Review **Depth** and keep defaults unless your format requires otherwise.

3. Confirm **Output value** shows the transformed result.

</details>