Filters

Filters transform a value before it is printed or compared. Chain them with |:

{post.title | default("Untitled") | upcase}
{tags | sort | join(", ")}

This page lists every built-in filter. Unknown filter names are reported as template errors, with a suggestion when the name is close to a real one.

Strings

• append(value) — add text to the end.
• prepend(value) — add text to the start.
• capitalize — uppercase the first character.
• upcase — uppercase the whole string.
• downcase — lowercase the whole string.
• replace(target, replacement) — replace every occurrence.
• replaceFirst(target, replacement) — replace the first occurrence.
• remove(value) — delete every occurrence.
• removeFirst(value) — delete the first occurrence.
• split(separator) — turn a string into an array.
• slice(start, length) — take part of a string or array. Negative starts count from the end.
• truncate(length, omission) — shorten to a character length. The omission defaults to ....
• truncateWords(count) — shorten to a word count with an ellipsis.
• strip — trim whitespace from both ends.
• lstrip — trim leading whitespace.
• rstrip — trim trailing whitespace.
• stripNewlines — remove newline characters.
• stripHTML — remove HTML tags.
• newlineToBR — turn newlines into <br> tags.
• slugify — lowercase and hyphenate for URLs.
• urlEncode — percent-encode for use in URLs.
• urlDecode — decode percent-encoding.

Arrays

• first — the first item.
• last — the last item.
• size — the number of items, or the length of a string.
• map(field) — collect one field from each item.
• where(field, value) — keep items whose field matches.
• sort(field) — sort by a field, or by value without one.
• sortNatural(field) — case-insensitive, human-friendly sort.
• reverse — reverse the order.
• unique — drop duplicate values.
• compact — drop nil values.
• concat(values) — append another array.
• join(separator) — combine items into a string.

Numbers

• plus(value), minus(value), times(value) — arithmetic.
• dividedBy(value) — division. Dividing by zero returns 0.
• modulo(value) — remainder.
• round(precision) — round, optionally to a number of decimal places.
• abs — absolute value.
• ceil — round up.
• floor — round down.
• atLeast(value) — clamp up to a minimum.
• atMost(value) — clamp down to a maximum.

Dates

Date filters accept ISO 8601 strings and Unix timestamps.

• date(format) — format with an ICU pattern such as "d MMMM yyyy", or Liquid-style % patterns.
• dateToString — a short standard date.
• dateToLongString — a longer standard date.
• dateToXMLSchema — ISO 8601, useful for <time datetime> and JSON Feed.
• dateToRFC822 — RFC 822, useful for RSS.

Output

• default(value) — substitute when the value is missing, an empty string, an empty array, or false. The number 0 is kept.
• json — encode the value as JSON.
• escape — HTML-escape a string.
• escape_once — HTML-escape without double-escaping existing entities.
• raw — mark trusted content as safe HTML. Use sparingly; see Syntax.