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

# String Split

> Split a string field in child objects using a provided delimiter

The String Split command (Command Type: 1015) splits a string field in each child object using a specified delimiter, replacing the field value with the resulting array.

## Overview

The String Split command provides functionality for:

* Splitting a string field into an array using a delimiter
* Applying the split to a specified field across all child objects
* Transforming delimited string values into iterable arrays

## Command Type

**Command Type ID:** 1015

## Parameters

| Parameter | Type   | Description                                                          | Required |
| --------- | ------ | -------------------------------------------------------------------- | -------- |
| **key**   | string | Specifies the property in the objects containing the string to split | Yes      |
| **split** | string | The delimiter or substring used to split the string                  | Yes      |

## Usage Examples

### Split Comma-Separated Tags

```json theme={null}
{
  "command": "string-split",
  "params": {
    "key": "tags",
    "split": ","
  }
}
```

### Split Pipe-Delimited IDs

```json theme={null}
{
  "command": "string-split",
  "params": {
    "key": "ids",
    "split": "|"
  }
}
```

### Split on Whitespace

```json theme={null}
{
  "command": "string-split",
  "params": {
    "key": "words",
    "split": " "
  }
}
```

## Common Use Cases

* **Tag Parsing**: Convert comma-separated tag strings into arrays
* **ID Lists**: Split delimited ID strings for downstream filtering or joining
* **Token Splitting**: Break formatted strings into parts for further processing

## Related Commands

* [Array Join](/stream/commands/parse/array-join) - Join array values back into a string
* [String Manipulation](/stream/commands/parse/string-manipulation) - Apply JS string methods to fields
* [Regex](/stream/commands/parse/regex) - Pattern-based string operations