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

# SPLIT

`SPLIT [n]`

The `SPLIT` instruction causes the runner to duplicate its entire state a number
of times at a specific point. Each copy of the runner will have `SPLIT` and
`SPLIT_NUM` environment variables automatically set. The former will be the
index of the runner, and the latter will be the number of copies.

`SPLIT UNORDERED [n]`

The `SPLIT UNORDERED` instruction behaves the same as the `SPLIT` instruction
without setting the `SPLIT` environment variable allowing all split runners to
have the same environment.

### Examples

* Use `SPLIT 3` and three copies of the runner will have
  `ENV SPLIT=0 SPLIT_NUM=3` and `ENV SPLIT=1 SPLIT_NUM=3` and so on.

* Use `SPLIT UNORDERED 3` and three copies of the runner will have
  `ENV SPLIT_NUM=3`.