---
title: "Liquid filters: replace"
description: Replaces any instance of a substring inside a string with a given string.
api_name: liquid
source_url:
  html: https://shopify.dev/docs/api/liquid/filters/replace
  md: https://shopify.dev/docs/api/liquid/filters/replace.md
---

# replace

```oobleck
string | replace: string, string
```

returns [string](https://shopify.dev/docs/api/liquid/basics#string)

Replaces any instance of a substring inside a string with a given string.

```liquid
{{ product.handle | replace: '-', ' ' }}
```

##### Code

```
{{ product.handle | replace: '-', ' ' }}
```

##### Data

```
{
  "product": {
    "handle": "komodo-dragon-scale"
  }
}
```

## Output

```html
komodo dragon scale
```