---
alias: user-guide-automation-converter-splitstring
description: "This converter splits the input string into an array of substrings using a delimiter"
---

# Split String

The **Split String** converter receives a string, splits it wherever the configured **Delimiter** appears, and returns the resulting array of pieces.

## Settings

| Name      | Data Type | Description                                                  |
| --------- | --------- | ------------------------------------------------------------ |
| delimiter | `String`  | Character or sequence of characters used to split the input  |

Table 1: Settings

![Settings panel for the Split String converter.](./images/converter_split_string_settings.png)

## Examples

| Input              | `delimiter` | Output                          |
| ------------------ | ----------- | ------------------------------- |
| `"Hello.World.!!"` | `.`         | `["Hello", "World", "!!"]`      |
| `"One,Two,Three"`  | `,`         | `["One", "Two", "Three"]`       |
| `"key=value"`      | `=`         | `["key", "value"]`              |
| `"left::right"`    | `::`        | `["left", "right"]`             |

Table 2: Examples

### Invalid Input

This converter fails in any of the cases below. For what happens to the rest of the chain when a converter fails (the error is logged, reported for monitoring, and the next task does not run), see [[user-guide-automation-converters-index]].

| Input          | `delimiter`         | Result                                                                                              |
| -------------- | ------------------- | --------------------------------------------------------------------------------------------------- |
| Any string     | *(not set / empty)* | Fails with `The provided delimiter is null or empty. Please provide a valid delimiter to split.`    |
| `"Hello World"`| `,`                 | Fails with `Delimiter "," was not found in the string provided.`                                    |

Table 3: Invalid Input