> For the complete documentation index, see [llms.txt](https://docs.fortifiedid.se/pipes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortifiedid.se/pipes/valves/item/item-property-replace.md).

# Item Property Replace

Valve that replaces the value, or part of the value, of an item property.

Replacement can be performed using tokens (substrings) or regular expressions.

If no token or regex is provided, the entire value will be replaced.

Valve can also create a new property containing the result of the replacement.

If a property contains multiple values, each value will be processed individually.

## Configuration

{% hint style="info" %}
**Valve name:** `ItemPropertyReplace`
{% endhint %}

{% tabs %}
{% tab title="Properties" %}

<table><thead><tr><th width="138">Name</th><th width="249">Description</th><th width="157">Default value</th><th width="130" data-type="checkbox">Mandatory</th><th width="125" data-type="checkbox">Expanded</th></tr></thead><tbody><tr><td><code>src</code></td><td>Name of property to replace</td><td></td><td>true</td><td>false</td></tr><tr><td><code>dest</code></td><td>Destination property of result. When supplied, <code>src</code> will not be modified.</td><td></td><td>false</td><td>false</td></tr><tr><td><code>token</code></td><td>Token (substring) in <code>src</code> to replace. Can match/replace one or more parts of the value.</td><td></td><td>false</td><td>false</td></tr><tr><td><code>regex</code></td><td>Regex matching part of <code>src</code> to replace. Can match/replace one or more parts of the value.</td><td></td><td>false</td><td>false</td></tr><tr><td><code>replacement</code></td><td>Replacement value. If not specified, no replacement vill be performed. Note: empty string ("") is a valid replacement.</td><td></td><td>false</td><td>true</td></tr></tbody></table>
{% endtab %}

{% tab title="Example" %}

```json
{
	"name": "ItemPropertyReplace",
	"config": {
		"item_include_expr": "item.id === 'result'"
		"src": "mail",
		"token": "@example.com",
		"replacement": "@test.org"
	}
}
```

{% endtab %}
{% endtabs %}