---
title: "split data processor"
manual: "TypoScript Explained"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3tsref:splitprocessor@13.4"
source: "DataProcessing/SplitProcessor.rst"
rendered: "2026-09-19T07:15:48+00:00"
---
# `split` data processor {#splitprocessor}
The `\TYPO3\CMS\Frontend\DataProcessing\SplitProcessor`,
alias `split`, allows to split values separated with a delimiter
from a single database field. The result is an array that can be iterated over.
Whitespaces are automatically trimmed.
**Table of contents**
- [Options](https://docs.typo3.org/permalink/t3tsref:options@13.4)
- [Example: Splitting a URL](https://docs.typo3.org/permalink/t3tsref:example-splitting-a-url@13.4)
## Options {#splitprocessor-options}
**if**
- **if**
- *Type:* [if](https://docs.typo3.org/permalink/t3tsref:if@13.4) condition
- *Required:* false
- *Default:* ''
Only if the condition is met the data processor is executed.
**fieldName**
- **fieldName**
- *Type:* [string](https://docs.typo3.org/permalink/t3tsref:data-type-string@13.4) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
- *Required:* true
- *Default:* ''
Name of the field to be used.
**as**
- **as**
- *Type:* [string](https://docs.typo3.org/permalink/t3tsref:data-type-string@13.4)
- *Required:* false
- *Default:* defaults to the fieldName
The variable name to be used in the Fluid template.
**delimiter**
- **delimiter**
- *Type:* [string](https://docs.typo3.org/permalink/t3tsref:data-type-string@13.4) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
- *Required:* false
- *Default:* Line Feed
- *Example:* ","
The field delimiter, a character separating the values.
**filterIntegers**
- **filterIntegers**
- *Type:* [boolean](https://docs.typo3.org/permalink/t3tsref:data-type-boolean@13.4) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
- *Required:* false
- *Default:* 0
- *Example:* 1
If set to `1`, all values are being cast to int.
**filterUnique**
- **filterUnique**
- *Type:* [boolean](https://docs.typo3.org/permalink/t3tsref:data-type-boolean@13.4) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
- *Required:* false
- *Default:* 0
- *Example:* 1
If set to `1`, all duplicates will be removed.
**removeEmptyEntries**
- **removeEmptyEntries**
- *Type:* [boolean](https://docs.typo3.org/permalink/t3tsref:data-type-boolean@13.4) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
- *Required:* false
- *Default:* 0
- *Example:* 1
If set to `1`, all empty values will be removed.
## Example: Splitting a URL {#splitprocessor-example-split-url}
Please see also [About the examples](https://docs.typo3.org/permalink/t3tsref:dataprocessing-about-examples@13.4).
**TypoScript**
With the help of the
`SplitProcessor` the following
scenario is possible:
**EXT:examples/Configuration/TypoScript/DataProcessors/Processors/SplitProcessor.typoscript**
```typoscript
tt_content {
examples_dataprocsplit =< lib.contentElement
examples_dataprocsplit {
templateName = DataProcSplit
dataProcessing.10 = split
dataProcessing.10 {
as = urlParts
delimiter = /
fieldName = header_link
removeEmptyEntries = 0
filterIntegers = 0
filterUnique = 0
}
}
}
```
**The Fluid template**
In the Fluid template then iterate over the split data:
**EXT:examples/Resources/Private/Templates/ContentElements/DataProcSplit.html**
```html
Data in variable urlParts
{urlParts}
Output
{part}
/
```
**Output**
The array now contains the split strings:
