Filters

Filters in Twig are used to modify the output of variables or expressions. They are an essential feature, allowing you to format data, transform strings, and perform other manipulations directly within your templates. On ShopWired, filters are applied using the pipe | character.

Common Filters in Twig 1

|upper

The upper filter converts a string to uppercase.

{{ "hello world" | upper }}

Output: HELLO WORLD

|lower

The lower filter converts a string to lowercase.

{{ "HELLO WORLD" | lower }}

Output: hello world

|title

The title filter capitalises the first letter of each word in a string.

{{ "hello world" | title }}

Output: Hello World

|length

The length filter returns the length of a string, array, or object.

{{ "hello" | length }}

Output: 5

|default

The default filter provides a fallback value if the variable is undefined or empty.

{{ global.customer.first_name | default('Guest') }}

Output: Guest (if global.customer.first_name is undefined)

|date

The date filter formats a date according to a given format.

{{ "now" | date("Y-m-d") }}

Output: The current date in YYYY-MM-DD format.

|replace

The replace filter replaces occurrences of a substring with another string.

{{ "hello world" | replace({"world": "Twig"}) }}

Output: hello Twig

|join

The join filter joins elements of an array into a string, with an optional separator.

{% set products = ['Nike Trainers', 'Adidas Trainers', 'Versace Trainers'] %} {{ products | join(', ') }}

Output: Nike Trainers, Adidas Trainers, Versace Trainers

|escape

The escape filter escapes HTML characters to prevent XSS attacks. This is particularly important when outputting user-generated content.

{{ "hello" | escape }}

Output: hello

|raw

The raw filter disables auto-escaping for a specific output. Use this filter carefully, especially with user-generated content, as it can expose your site to XSS vulnerabilities.

{{ "hello" | raw }}