---
title: "Liquid filters: truncate"
description: Truncates a string down to a given number of characters.
api_name: liquid
source_url:
  html: https://shopify.dev/docs/api/liquid/filters/truncate
  md: https://shopify.dev/docs/api/liquid/filters/truncate.md
---

# truncate

```oobleck
string | truncate: number
```

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

Truncates a string down to a given number of characters.

If the specified number of characters is less than the length of the string, then an ellipsis (`...`) is appended to the truncated string. The ellipsis is included in the character count of the truncated string.

```liquid
{{ article.title | truncate: 15 }}
```

##### Code

```
{{ article.title | truncate: 15 }}
```

##### Data

```
{
  "article": {
    "title": "How to tell if you're out of invisibility potion"
  }
}
```

## Output

```html
How to tell ...
```

### Specify a custom ellipsis

```oobleck
string | truncate: number, string
```

You can provide a second parameter to specify a custom ellipsis. If you don't want an ellipsis, then you can supply an empty string.

```liquid
{{ article.title | truncate: 15, '--' }}
{{ article.title | truncate: 15, '' }}
```

##### Code

```
{{ article.title | truncate: 15, '--' }}
{{ article.title | truncate: 15, '' }}
```

##### Data

```
{
  "article": {
    "title": "How to tell if you're out of invisibility potion"
  }
}
```

## Output

```html
How to tell i--
How to tell if
```