---
title: fn::split
url: /docs/esc/environments/syntax/builtin-functions/fn-split/
---
The `fn::split` built-in function splits a string into a list of strings using a given delimiter. If any input to `fn::split` is a secret, the result is also a secret.

## Declaration

```yaml
fn::split: [delimiter, value ]
```

### Parameters

| Property    | Type   | Description                                                       |
|-------------|--------|-------------------------------------------------------------------|
| `delimiter` | string | The delimiter to use when splitting the string
| `value`     | string | The string to split

### Returns

A list of strings created by splitting `value` by `delimiter`.

## Example

### Definition

```yaml
values:
  joined-string: "one, two, three"
  split:
    fn::split: [", ", ${joined-string} ]
```

### Evaluated result

```json
{
  "joined-string": "one, two, three",
  "split": ["one",
    "two",
    "three"
  ]
}
```