Liquid filters
Filters change the output of a Liquid object. They are used within an object and are separated by a pipe character.
Filters let you change the way that a Liquid object is displayed. In Current, you'll find the currency
, number
, and localedate
filters used a lot in our document layouts.
Filters are placed within an object after a pipe character( |
), with optional data supplied after a colon.
Common filters
localedate
localedate
Formats a date as per the logged in user’s language settings.
Input
{{ invoice.invoiced_at | localedate }}
Output
In “English (United States),” this might output 1/12/2021
(M/D/YYY) but in other languages this might output 12/01/2021
(DD/MM/YYYY).
localedatetime
localedatetime
Formats the date and time as per the logged in user’s language settings.
Input
{{ order.deliver_starts_at | localedatetime }}
Output
In “English (United States),” this might output 1/12/2021 5:30PM
(M/D/YYY 12hr clock) but in other languages this might output 12/01/2021 17:30
(DD/MM/YYYY 24hr clock).
timezone
timezone
When using 'now'
to return the date and time now, Current RMS returns the UTC time. Use timezone
to change the date and time to a particular region.
{{ 'now' | timezone:"Europe/London" | localedatetime }}
For a list of timezones, edit your user profile and check the “Timezone” drop-down.
Date filter referencenumber
number
A decimal precision formatter. You can specify how many decimal places you’d like to add.
Input
{{ item.quantity | number }}
{{ item.quantity | number:3 }}
Output
1
1.000
currency
currency
Formats a number using the currency symbol set in System Preferences and the user’s language settings.
Input
{{ item.price | currency }}
Output
$149.00
newline_to_br
newline_to_br
Where you’ve inserted a new line into a text field (\n
), this filter inserts an HTML break (<br>
).
Input
{{ order.external_description | newline_to_br }}
Output
Thanks for your interest.
Contact us if we can do anything.
markdown
markdown
Tells Current to format text as Markdown.
Input
{{ order.external_description | markdown }}
Where the external description is...
**Thank you for your interest!** Contact us if we can do _anything_.
Output
Thank you for your interest! Contact us if we can do anything.
bool_to_word
bool_to_word
Converts true or false into “Yes” and “No” in your local language.
Input
{{ item.has_discount? | bool_to_word }}
Output
Yes
to_words
to_words
Outputs numbers to words, useful for regions where invoices must show the amount due in words.
Input
{{ invoice.charge_including_tax_total | to_words }}
Output
One hundred and ninety nine
String filters
append
append
Add information to the end of a string:
Input
{{ order.name | append:"!" }}
Output
V-Blast Music Festival!
capitalize
capitalize
Makes the first letter of a string capitalized.
Input
{{ order.name | capitalize }}
Output
V-blast music festival
downcase
downcase
Change the output to lowercase.
Input
{{ order.name | downcase }}
Output
v-blast music festival
prepend
prepend
Add information to the start of a string:
Input
{{ order.name | prepend:"We are preparing your order: " }}
Output
We are preparing your order: V-Blast Music Festival
remove
remove
Removes every occurrence of a particular substring from a string.
Input
{{ order.name | remove:"Festival" }}
Output
V-Blast Music
remove_first
remove_first
Removes the first occurrence of a particular substring from a string.
Input
{{ order.name | remove_first:"Festival" }}
Output
V-Blast Music
truncate
truncate
Truncate a string to a particular number of characters.
Input
{{ order.name | truncate:3 }}
Output
V-Bl
upcase
upcase
Change the output to uppercase.
Input
{{ order.name | upcase }}
Output
V-BLAST MUSIC FESTIVAL
Maths filters
ceil
ceil
Rounds up to the nearest integer.
Input
{{ item.price | ceil }}
Output
If the item price is 1.60, this will be 2.
If the item price is 1.30, this will still be 2.
divided_by
divided_by
Divides an output by a number.
Input
{{ item.price | divided_by:2 }}
floor
floor
Rounds down to the nearest integer.
Input
{{ item.price | floor }}
Output
If the item price is 1.60, this will be 1.
If the item price is 1.30, this will also be 1.
minus
minus
Subtracts a number from an output.
Input
{{ order.charge_including_tax_total | minus:order.tax_total }}
modulo
modulo
Divides an output by a number and returns the remainder.
plus
plus
Adds a number to an output.
Input
{{ item.price | plus:10 }}
round
round
Rounds the output to the nearest integer or specified number of decimals.
Input
{{ item.price | round }}
Output
If the item price is 1.60, this will be 2.
If the item price is 1.30, this will be 1.
times
times
Multiplies an output by a number.
Input
{{ item.price | times:2 }}
Array filters
first
first
Returns the first item in an array.
Input
{{ item.accessories | first }}
last
last
Returns the last item in an array.
Input
{{ item.accessories | last }}
sort
sort
Sorts an array by a given attribute.
Input
{% assign sorted_quotations = project.quotations | sort:'name' %}
Last updated
Was this helpful?