summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/replace.md
blob: 36e3920151c88300ae8131ba271487f9437eb594 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
---
title: replace
description: Replaces all occurrences of the search string with the replacement string.
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2020-09-07
categories: [functions]
menu:
  docs:
    parent: "functions"
keywords: [replace]
signature: 
  - "replace INPUT OLD NEW [LIMIT]"
  - "strings.Replace INPUT OLD NEW [LIMIT]"
workson: []
hugoversion:
relatedfuncs: [replaceRE]
deprecated: false
aliases: []
---

Replace returns a copy of `INPUT` with all occurrences of `OLD` replaced with `NEW`.
The number of replacements can be limited with an optional `LIMIT` parameter.

```
`{{ replace "Batman and Robin" "Robin" "Catwoman" }}`
→ "Batman and Catwoman"

{{ replace "aabbaabb" "a" "z" 2 }} → "zzbbaabb"
```