> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/6/studio/tasks/reference/split/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# split

> Use the split task to split a string into an array of substrings using a separator.

The `split` task splits a string into an array of substrings at each occurrence of a given separator. The original string is not changed.

## Potential use case

A comma-separated list of ticket numbers is provided to the automation. Use the `split` task to create an array of ticket numbers for subsequent processing in the workflow.

## Properties

| Input       | Type   | Description                                                                                                                                                                                       |
| :---------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `str`       | String | Required. The string to split.                                                                                                                                                                    |
| `separator` | String | The point where each split occurs. Can be a single or multiple characters. If omitted, the entire string becomes a single array element. If an empty string (`""`), every character is separated. |
| `limit`     | Number | The number of splits to make. Items after the split limit are not included in the returned array. Can be zero or a non-negative integer.                                                          |

| Output       | Type  | Description                                                                               |
| :----------- | :---- | :---------------------------------------------------------------------------------------- |
| `splitArray` | Array | An array of strings formed by splitting the original string at each separator occurrence. |

## Example

The incoming `str` variable is required.

![](/_fern-img/0f92b4cef091373fa784c471aa8d5cf56a6c15b215ee255f34c404360d2e3232.webp)

The variables are set before running the workflow. In this example, the string is `"Hello World"`, the separator is the letter `"o"`, and the limit is `3`.

![](/_fern-img/52f76f6c2ae7ce54d41e037a6f3d590da9d6a579c2c42527e1f909b96929ec3c.webp)

After the workflow runs, the output is visible in **Task History** (accessed from Jobs in Operations Manager). Three splits were made at each occurrence of `"o"`. Note that `split` also recognizes and includes whitespace.

![](/_fern-img/622182a3b27feb8b191c76a2aac28c0be53e7073ee0f1b3399f2e8497e80b09f.webp)

> Use the split task to split a string into an array of substrings using a separator.