---
title: "flatten"
slug: "tools-flatten"
updated: 2025-11-06T19:01:09Z
published: 2025-11-06T19:01:09Z
canonical: "docs.doc-know.com/tools-flatten"
---

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

# flatten

### tools.flatten

Returns a string of all items in the passed array, separated by the specified separator.

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **array** | Array | Yes | Array of items |
| **separator** | Text | No | Item separator in returned string |

### Returns

Type: **Text**

Returns a new string, representing the array of the passed items, separated by the specified separator.

### Examples

```
// returns a string containing the following colors, separated by commas
var colors = ["red", "white", "blue"];
var results = tools.flatten(colors, ",");
debug.log(results);
```

### Remarks

None.