Variables

{{ string | append: string }}

Adds a given string to the end of a string.

{{ string | capitalize }}

Capitalizes the first word in a string and downcases the remaining characters.

{{ array | compact }}

Removes any nil items from an array.

{{ string | date: string }}

Converts a timestamp into another date format. The date filter accepts the same parameters as Ruby's strftime method for formatting the date. For a list of shorthand formats, refer to the Ruby documentation or strftime reference and sandbox.

The current date

You can apply the date filter to the keywords 'now' and 'today' to output the current timestamp.

{{ variable | default: variable }}

Sets a default value for any variable whose value is empty, false, or nil.

allow_false

{{ variable | default: variable, allow_false: boolean }}

By default, the default filter's value will be used in place of false values. You can use the allow_false parameter to allow variables to return false instead of the default value.

{{ number | divided_by: number }}

Divides a number by a given number. The divided_by filter produces a result of the same type as the divisor. This means if you divide by an integer, the result will be an integer, and if you divide by a float, the result will be a float.

{{ string | downcase }}

Converts a string to all lowercase characters.

{{ string | escape }}

Escapes special characters in HTML, such as <>, ', and &, and converts characters into escape sequences. The filter doesn't effect characters within the string that don't have a corresponding escape sequence.

{{ array | join }}

Combines all of the items in an array into a single string, separated by a space.

Custom separator

{{ array | join: string }}

You can specify a custom separator for the joined items.

{{ variable | json }}

Converts an array, oject, or string into JSON format.

{{ string | link_to_tag }}

Generates an HTML <a> tag with an href attribute linking to the current collection, filtered to show only products that have the given tag.

{{ array | map: string }}

Creates an array of values from a specific property of the items in an array.

{{ metafield | metafield_tag }}

Generates an HTML element to host the metafield data. The type of element that's generated differs depending on the type of metafield.

Note

The metafield_tag filter doesn't support list metafields other than list.single_line_text_field.

{{ metafield | metafield_text }}

Generates a text version of the metafield data.

{{ number | minus: number }}

Subtracts a given number from another number.

{{ number | money }}

Formats a given price based on the store's HTML without currency setting.

{{ number | money_with_currency }}

Formats a given price based on the store's HTML without currency setting, with the currency symbol.

{{ number | money_without_currency }}

Formats a given price based on the store's HTML without currency setting, without the currency symbol.

{{ number | money_without_trailing_zeroes }}

Formats a given price based on the store's HTML without currency setting, excluding the decimal separator (either . or ,) and trailing zeros. If the price has a non-zero decimal value, then the output is the same as the money filter.

{{ number | plus: number }}

Adds two numbers.

{{ string | prepend: string }}

Adds a given string to the beginning of a string.

{{ string | replace: string, string }}

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

{{ string | replace_first: string, string }}

Replaces the first instance of a substring inside a string with a given string.

{{ string | replace_last: string, string }}

Replaces the last instance of a substring inside a string with a given string.

{{ number | round }}

Rounds a number to the nearest integer.

{{ array | size }}

returns number

Returns the number of items in the array.

{{ variable | slice }}

Returns a substring or series of array items, starting at a given 0-based index. By default, the substring has a length of one character, and the array series has one array item. However, you can provide a second parameter to specify the number of characters or array items.

Negative index

You can supply a negative index which will count from the end of the string or array.

{{ array | sort }}

Sorts the items in an array in case-sensitive alphabetical, or numerical, order.

{{ array | sort_natural }}

Sorts the items in an array in case-insensitive alphabetical order.

{{ string | split: string }}

Splits a string into an array of substrings based on a given separator.

{{ string | strip_html }}

Strips all HTML tags from a string.

{{ number | times: number }}

Multiplies a number by a given number.

{{ string | truncate: number }}

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.

Specify a custom ellipsis

{{ 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.

{{ string | truncate_words: number }}

Truncates a string down to a given number of words. If the specified number of words is less than the number of words in the string, then an ellipsis (...) is appended to the truncated string.

Specify a custom ellipsis

{{ string | truncate_words: 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.

Caution

HTML tags are treated as words, so you should strip any HTML from truncated content. If you don't strip HTML, then closing HTML tags can be removed, which can result in unexpected behavior.

{{ array | uniq }}

Removes any duplicate items in an array.

{{ string | upcase }}

Converts a string to all uppercase characters.

{{ number | weight_with_unit }}

Generates a formatted weight for a variant object. The weight unit is set in the general settings in the Shopify admin.

Override the default unit

{{ number | weight_with_unit: variable }}

You can specify a unit to override the default from the general settings.

{{ array | where: string, string }}

Filters an array to include only items with a specific property value. This requires you to provide both the property name and the associated value.

Filter for boolean properties with a true value

You can filter for items that have a true value for a boolean property. This requires you to provide only the property name.