Advanced filters

This reference article provides an overview of advanced filters in Liquid and how they can be used.

Encoding filters

filter name filter description example input example output

md5 Returns md5 encoded string {{'hey' | md5}} 6057f13c496ecf7fd777ceb9e79ae285

sha1 Returns sha1 encoded string {{'hey' | sha1}} 7f550a9f4c44173a37664d938f1355f0f92a47a7

sha2 Returns sha2 (256-bit, also known as SHA-256) encoded string {{'hey' | sha2}} fa690b82061edfd2852629aeba8a8977b57e40fcb77d1a7a28b26cba62591204

base64 Returns base64 encoded string {{'blah' | base64_encode}} YmxhaA==

hmac_sha1_hex (previously hmac_sha1) Returns hmac-sha1 signature, encoded as a hex string {{'hey' | hmac_sha1_hex: 'secret_key'}} 2a3969bed25bfeefb00aca4063eb9590b4df8f0e

hmac_sha1_base64 Returns hmac-sha1 signature, encoded as a base64 string {{'hey' | hmac_sha1_base64: 'secret_key'}} KjlpvtJb/u+wCspAY+uVkLTfjw4=

hmac_sha256_hex Returns hmac-sha256 signature, encoded as a hex string {{'hey' | hmac_sha256_hex: 'secret_key'}} 8df897f8da3d7992fe57c8dbc6f27578cfbf2dcc4d0fbb4000b8c924841d508e

hmac_sha256_base64 Returns hmac-sha256 signature, encoded as a base64 string {{'hey' | hmac_sha256_base64: 'secret_key'}} jfiX+No9eZL+V8jbxvJ1eM+/LcxND7tAALjJJIQdUI4=

URL filters

filter name filter description example input example output

url_escape Identifies all characters in a string that are not allowed in URLS, and replaces the characters with their escaped variants {{'hey<>hi' | url_escape}} hey%3C%3Ehi

url_param_escape Replaces all characters in a string that are not allowed in URLs with their escaped variants, including the ampersand (&) {{'hey<&>hi' | url_param_escape} hey%3C%26%3Ehi

url_encode Encodes a string that is URL friendly {{ 'google search' | url_encode }} google+search

tip:

The assign tag can be combined with HTML to save you time and effort when creating multiple hyperlinks.

{% assign url = "https://www.examplelink.com" %}
<a href='{{url}}'>Shop the collection</a>

Property accessor filter

filter name filter description

property_accessor Takes a hash and hash key and returns the value in that hash at that key

Example hash: {"a" => 42, "b" => 0} Example input: {{hash | property_accessor: 'a'}} Example output: 42

Additionally, the property accessor filter allows you to template a custom attribute into a hash key to access a particular hash value.

note:

There is no way to instantiate a hash as a variable (such as an expression) in Liquid within Braze.

Number formatting filters

filter name filter description example input example output

number_with_delimiter Formats a number with commas {{ 123456 | number_with_delimiter }} 123,456

JSON escape / string escape filter

filter name filter description

json_escape Escapes any special characters in a string (such as double quote "" and backslash ‘').

This filter should always be used when personalizing a string in a JSON dictionary and is useful for webhooks in particular.

Edit this page on GitHub

HOW HELPFUL WAS THIS PAGE?

Edit this page on GitHub

New Stuff!