Filters

array | batch(count: integer)

Batches items by the given number and returns an array of arrays.

{{ ['Lisbon', 'San Francisco', 'Kyoto', 'Bangkok', 'Oslo'] | batch(count=2) }}

[['Lisbon', 'San Francisco'], ['Kyoto', 'Bangkok'], ['Oslo']]

array | batch(count: integer, fill_with: string)

Use the fill_with parameter to fill an incomplete array to the given count.

{{ ['Lisbon', 'San Francisco', 'Kyoto', 'Bangkok', 'Oslo'] | batch(count=2, fill_with='x') }}

[['Lisbon', 'San Francisco'], ['Kyoto', 'Bangkok'], ['Oslo', 'x']]

array | chunk(count: integer)

Splits an array and returns an array of the given number of arrays.

{{ ['Lisbon', 'San Francisco', 'Kyoto', 'Bangkok', 'Oslo'] | chunk(count=2) }}

[['Lisbon', 'San Francisco', 'Kyoto'], ['Bangkok', 'Oslo']]

array | chunk(count: integer, collate: boolean)

Use the collate parameter to collate items when slicing an array. This can be useful to create lists that represent columns. The default value is False.

{{ ['Lisbon', 'San Francisco', 'Kyoto', 'Bangkok', 'Oslo'] | chunk(count=2, collate=True) }}

[['Lisbon', 'Kyoto', 'Oslo'], ['San Francisco', 'Bangkok']]

array | chunk(count: integer, fill_with: string)

Use the fill_with parameter to fill up missing items in each array.

{{ ['Lisbon', 'San Francisco', 'Kyoto', 'Bangkok', 'Oslo'] | chunk(count=2, fill_with='x') }}

[['Lisbon', 'San Francisco', 'Kyoto'], ['Bangkok', 'Oslo', 'x']]

array | first

Returns the first item of an array.

{{ ['Stockholm', 'Vancouver', 'Boston'] | first }}

Stockholm

string | first

Returns the first character of a string.

{{ 'Stockholm' | first }}

S

array | join

Combines all items of an array into a string.

{{ ['London', 'Lisbon', 'Bangkok'] | join }}

LondonLisbonBangkok

array | join(separator: string)

Use the separator parameter to separate the items with the specified string. By default, items are combined without a separator.

{{ ['London', 'Lisbon', 'Bangkok'] | join(', ') }}

London, Lisbon, Bangkok

array | last

Returns the last item of an array.

{{ ['Stockholm', 'Vancouver', 'Boston'] | last }}

Boston

string | last

Returns the last character of a string.

{{ 'Stockholm' | last }}

m

array | length

Returns the number of items in an array.

{{ ['New York', 'Austin', 'Toronto'] | length }}

3

string | length

Returns the number of characters in a string.

{{ 'New York' | length }}

8

Applies a filter on all items in an array or creates an array of property values.

array | map(filter: string)

Applies specified filter on all items in an array.

{{ ['Lisbon', 'San Francisco', 'Kyoto'] | map(filter='upper') }}

['LISBON', 'SAN FRANCISCO', 'KYOTO']

array | map(property: string, default: string)

Creates an array of property values. Use the default parameter to set default values for empty properties in case the specified property is not found.

{{ document.dates | map(property='title') }}

['Issue Date', 'Delivery Date', 'Due Date']

{{ document.dates | map(property='text', default='Unset') }}

['04-02-2022', '08-02-2022', 'Unset']

array | reject(property: string, value: string)

Returns an array that excludes items based on their property value.

{{ document.dates | reject(property='title', value='Due Date') | map(property='title') }}

['Issue Date', 'Delivery Date']

array | reverse(join: string)

Reverses the order of items in an array. Use the join parameter to separate the items with the specified string. By default, items are combined without a separator.

{{ ['Oslo', 'Stockholm', 'Helsinki'] | reverse }}

['Helsinki', 'Stockholm', 'Oslo']

string | reverse

Use the filter to reverse a string.

{{ 'Oslo' | reverse }}

olsO

array | select(property: string, value: string)

Creates an array that includes items based on a property value.

{{ document.dates | select(property='title', value='Due Date') | map(property='title') }}

['Due Date']

array | sort

Sorts the items in an array in alphabetical or numerical order.

{{ ['Rome', 'Athens', 'Cairo'] | sort }}

['Athens', 'Cairo', 'Rome']

array | sort(reverse: boolean)

Use the reverse parameter to sort the array items in reverse alphabetical or numerical order. The default value is False.

{{ ['Rome', 'Athens', 'Cairo'] | sort(reverse=True) }}

['Rome', 'Cairo', 'Athens']

array | sort(case_sensitive: boolean)

Use the case_sensitive parameter to sort the array items in case-sensitive order. The default is False.

{{ ['Athens', 'cairo', 'athens', 'Cairo'] | sort(case_sensitive=True) }}

['Athens', 'Cairo', 'athens', 'cairo']

array | sort(property: string)

Use the property parameter to sort the array items by their property in alphabetical or numerical order.

{{ document.dates | sort(property='title') | map(property='title') }}

['Delivery Date', 'Due Date', 'Issue Date']

string | sort

Sorts the characters of a string.

{{ 'Cairo' | sort }}

aCior

array | unique

Removes any duplicate items from the array. By default, the filter is not case-sensitive.

{{ ['London', 'london', 'Paris', 'London'] | unique }}

['London', 'Paris']

array | unique(case_sensitive: boolean)

Use the case_sensitive parameter to keep all case-sensitive variations of one item. The default value is False.

{{ ['London', 'london', 'Paris', 'London'] | unique(case_sensitive=True) }}

['London', 'london', 'Paris']

array | unique(property: string)

Use the property parameter to remove the duplicate array items by their property.

{{ document.dates | unique(property='text') | map(property='text') }}

['01-01-2023', '01-14-2023']

string | qr_code

Renders the string as a QR code.

{{ 'Invoice 1042' | qr_code }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="84" height="84" class="qrcode"><path transform="scale(2)" class="qrline" stroke="#000" d="M0 0.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></svg></div>

string | qr_code(scale: float)

Use the scale parameter to resize the QR code. The default value is 2.

{{ 'Invoice 1042' | qr_code(scale=4) }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="84" height="84" class="qrcode"><path transform="scale(4)" class="qrline" stroke="#000" d="M0 0.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></svg></div>

string | qr_code(border: integer)

Use the border parameter to add a border around the QR code. The default value is 0.

{{ 'Invoice 1042' | qr_code(border=1) }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="46" height="46" class="qrcode"><path transform="scale(2)" class="qrline" stroke="#000" d="M1 1.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></svg></div>

string | qr_code(color: string)

Use the color parameter to change the color of the QR code. Accepts color names and hex codes. The default color is black.

{{ 'Invoice 1042' | qr_code(color='grey') }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="42" height="42" class="qrcode"><path transform="scale(2)" class="qrline" stroke="#808080" d="M0 0.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></svg></div>

string | qr_code(background: string)

Use the background parameter to change the color of the background of the QR code. Accepts color names and hex codes. The default color is white.

{{ 'Invoice 1042' | qr_code(background='#483C32') }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="42" height="42" class="qrcode"><g transform="scale(2)"><path fill="#483c32" d="M0 0h21v21h-21z"></path><path class="qrline" stroke="#000" d="M0 0.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></g></svg></div>

string | qr_code(title: string)

Use the title parameter to add an image title to the generated QR code.

{{ 'Invoice 1042' | qr_code(title='QR code') }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="42" height="42" class="qrcode"><title>QR code</title><path transform="scale(2)" class="qrline" stroke="#000" d="M0 0.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></svg></div>

string | qr_code(logo: string, logo_width: string)

Use the logo parameter to add an image to the center of the QR code. Use the logo_width parameter to resize the logo. Supports all common image formats.

{{ 'Invoice 1042' | qr_code(color='483C32', background='A8A199', logo='https://sufio.com/static/infoweb/images/logo/logo-white@2x.png', logo_width='20px') }}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="42" height="42" class="qrcode"><g transform="scale(2)"><path fill="#a8a199" d="M0 0h21v21h-21z"></path><path class="qrline" stroke="#483c32" d="M0 0.5h7m1 0h1m1 0h1m1 0h1m1 0h7m-21 1h1m5 0h1m1 0h3m1 0h1m1 0h1m5 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m5 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m2 0h1m1 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h1m2 0h2m1 0h1m1 0h3m1 0h1m-21 1h1m5 0h1m2 0h2m3 0h1m5 0h1m-21 1h7m1 0h1m1 0h1m1 0h1m1 0h7m-12 1h2m-11 1h1m2 0h6m1 0h2m1 0h1m2 0h1m1 0h3m-21 1h1m1 0h4m2 0h3m1 0h1m1 0h1m2 0h1m-15 1h5m3 0h2m1 0h2m1 0h1m1 0h2m-20 1h1m2 0h2m2 0h2m1 0h2m2 0h2m1 0h2m-20 1h2m2 0h4m1 0h4m3 0h1m2 0h1m-12 1h3m1 0h3m1 0h5m-21 1h7m1 0h3m1 0h1m3 0h1m-17 1h1m5 0h1m1 0h2m4 0h2m1 0h2m1 0h1m-21 1h1m1 0h3m1 0h1m1 0h2m1 0h3m1 0h1m1 0h1m1 0h1m-20 1h1m1 0h3m1 0h1m1 0h1m1 0h1m-11 1h1m1 0h3m1 0h1m4 0h4m1 0h1m2 0h2m-21 1h1m5 0h1m2 0h2m1 0h4m1 0h4m-21 1h7m1 0h2m1 0h2m1 0h2"></path></g></svg><img src="https://sufio.com/static/infoweb/images/logo/logo-white@2x.png" class="qr-code-logo" style="position: absolute; top: 50%; left: 50%; transform: translate(-50%,-50%); width: 20px;"></div>

string | qr_code_ksa

Auto-fills and creates QR codes for invoices in Saudi Arabia. We recommend you insert the filter as a function without any input property.

Can be used with the same parameters as qr_code.

{% filter qr_code_ksa %}{% endfilter %}

<div class="qr-code-wrapper" style="display: inline-block; position: relative;"><svg width="66" height="66" class="qrcode"><path transform="scale(2)" class="qrline" stroke="#000" d="M0 0.5h7m3 0h5m1 0h2m1 0h4m3 0h7m-33 1h1m5 0h1m1 0h3m2 0h1m1 0h2m1 0h1m1 0h3m3 0h1m5 0h1m-33 1h1m1 0h3m1 0h1m2 0h3m3 0h1m2 0h1m2 0h2m3 0h1m1 0h3m1 0h1m-33 1h1m1 0h3m1 0h1m1 0h2m2 0h1m1 0h1m5 0h5m1 0h1m1 0h3m1 0h1m-33 1h1m1 0h3m1 0h1m2 0h1m1 0h1m1 0h1m1 0h4m1 0h1m5 0h1m1 0h3m1 0h1m-33 1h1m5 0h1m1 0h2m2 0h4m1 0h1m3 0h2m3 0h1m5 0h1m-33 1h7m1 0h1m1 0h1m1 0h1m1 0h1m1 0h1m1 0h1m1 0h1m1 0h1m1 0h1m1 0h7m-24 1h1m4 0h1m3 0h5m1 0h1m-25 1h5m1 0h4m4 0h1m5 0h1m1 0h1m1 0h2m1 0h1m1 0h1m1 0h1m-31 1h1m1 0h2m3 0h1m5 0h1m1 0h1m1 0h1m1 0h1m4 0h3m2 0h1m1 0h1m-33 1h3m3 0h1m1 0h1m1 0h1m1 0h2m1 0h1m4 0h1m6 0h5m-32 1h2m1 0h2m2 0h2m2 0h1m2 0h1m3 0h1m1 0h2m2 0h1m2 0h1m1 0h2m1 0h1m-29 1h1m1 0h1m1 0h6m1 0h1m1 0h1m1 0h1m1 0h2m1 0h2m1 0h1m1 0h4m-31 1h1m1 0h2m3 0h1m4 0h5m1 0h2m3 0h1m3 0h2m-31 1h3m3 0h5m3 0h4m3 0h1m4 0h1m2 0h1m1 0h1m-32 1h1m2 0h1m3 0h1m2 0h1m4 0h2m4 0h4m1 0h6m-32 1h2m1 0h2m1 0h1m1 0h1m1 0h1m2 0h1m1 0h1m1 0h1m1 0h2m1 0h1m1 0h2m2 0h1m1 0h1m1 0h1m-33 1h1m2 0h3m4 0h2m2 0h4m1 0h2m1 0h1m2 0h1m3 0h1m1 0h2m-32 1h2m1 0h1m1 0h1m1 0h2m5 0h4m2 0h1m4 0h1m1 0h1m-28 1h1m2 0h1m3 0h3m3 0h1m1 0h1m1 0h1m2 0h2m4 0h1m1 0h3m-32 1h1m3 0h1m1 0h2m1 0h2m1 0h1m1 0h1m5 0h3m1 0h2m-26 1h3m1 0h2m2 0h2m3 0h1m2 0h4m9 0h1m1 0h1m-32 1h1m4 0h2m1 0h3m1 0h4m4 0h1m1 0h1m1 0h3m1 0h2m1 0h1m-32 1h1m1 0h4m1 0h1m6 0h1m1 0h1m4 0h1m4 0h2m1 0h3m-32 1h1m3 0h1m1 0h1m2 0h1m2 0h1m1 0h2m3 0h4m1 0h7m-23 1h2m5 0h2m1 0h4m2 0h1m3 0h1m-29 1h7m1 0h2m2 0h1m2 0h2m3 0h1m3 0h1m1 0h1m1 0h4m-32 1h1m5 0h1m3 0h2m2 0h1m1 0h1m1 0h1m1 0h5m3 0h3m-31 1h1m1 0h3m1 0h1m1 0h2m1 0h2m1 0h1m2 0h1m1 0h1m4 0h9m-33 1h1m1 0h3m1 0h1m1 0h1m5 0h5m1 0h5m3 0h3m-31 1h1m1 0h3m1 0h1m1 0h3m1 0h1m1 0h4m2 0h2m3 0h2m2 0h1m1 0h1m-32 1h1m5 0h1m1 0h4m2 0h1m1 0h1m2 0h3m2 0h1m2 0h4m-31 1h7m1 0h1m1 0h1m1 0h1m1 0h4m2 0h1m1 0h3m4 0h3"></path></svg></div>

string | font_size_to_fit_text(max_width: string)

Returns a font-size style in em that will downsize the provided string so that the entire string fits the width defined by the max_width parameter. If no downsizing is needed, the filter does not return anything.

This filter ensures that the entire text, such as a document name, fits into a single line.

{{ 'Credit Note' | font_size_to_fit_text(max_width='2pc') }}

font-size: 0.4em

Use the filter as a property in the style attribute.

<div class="document-name-large"
    style="{{ document.name | font_size_to_fit_text(max_width='1pc') }}">
    {{ document.name.text }}
</div>

<div class="document-name-large" style="font-size: 0.63em;">
    Invoice
</div>

string | font_size_to_fit_text(max_width: string, fit_words: boolean)

Use the fit_words parameter to return a font size that will fit all individual words of the provided string. The default value is False.

This parameter ensures that the individual words of a text fit into a single line, while allowing the entire text to break across multiple lines.

{{ 'Credit Note' | font_size_to_fit_text(max_width='2pc', fit_words=True) }}

font-size: 0.75em

string | date

Converts a string with date or combined date and time format to ISO 8061 date and time format.

{{ '2020-01-30' | date }}

2022-01-30 00:00:00

{{ '2022-01-30T09:42:07' | date }}

2022-01-30 09:42:07

string | date(format: string)

Converts a string in a custom date format to an ISO 8601 date and time format. Use the format parameter to specify the original date format according to the Python strftime/strptime format codes.

{{ '01/30/2020' | date(format='%m/%d/%Y') }}

2020-01-30 00:00:00

now()

Returns the current date and time in your account’s timezone.

{{ now() }}

2023-01-24 09:42:15

string | default(string)

Sets a default value for any variable that has an empty string, an empty array, False, or None as its value.

{{ document.notes | default(value='This document has no notes.') }}

This document has no notes.

date | delta(parameter: string)

Adds or subtracts an amount of time specified in seconds, minutes, hours, days, weeks, months or years.

{{ '2000-01-01' | date | delta(years=1, months=2, weeks=2, days=1, hours=3, minutes=30, seconds=15) }}

2001-03-16 03:30:15

{{ '2000-01-01' | date | delta(seconds=-30) }}

1999-12-31 23:59:30

string | float

Converts a string to a floating point number.

{{ '42.3' | float }}

42.3

string | format(format_string: string)

Applies specified values to a printf-style format string.

For example, use the filter with the %0xd value as a parameter, where x specifies the number of digits, to add zeroes to the beginning of a number.

{{ 1042 | format(format_string='%06d') }}

001042

Use the filter with the %.xf value as a parameter, where x specifies the number of decimals, to truncate the number of decimal places of a float.

{{ 12.42 | format(format_string='%.1f') }}

12.4

date | format_date

Returns the date  as a string in the format based on the document language.

{{ '2020-01-30T13:42:00' | date | format_date }}

Jan. 30, 2020

date | format_date(format: string)

Use the format parameter to define a custom date format according to the Python strftime/strptime format codes.

{{ '2020-01-30T13:42:00' | date | format_date(format='%m/%d/%Y') }}

01/30/2020

Use the year , month, day, hour, minute or second properties of a date to return the specific part of the date.

{{ document.dates.issue_date.year }} {{ document.dates.issue_date.month }}

2023 11

string | int

Converts a string to an integer.

{{ '42' | int }}

42

string | json_query(path: string)

Returns the specified value from a JSON string using JMESPath.

{{ '{"name": {"first": "John", "last": "Smith"}}' | json_query(path='name.first') }}

John

string | label(title: string)

Adds a label, suffixed by a colon, before a string. If the string is empty, no label is added.

{{ 'John' | label(title='Name') }}

Name: John

string | list

Returns the values as a list.

{{ document.dates | list }}

[DateField(2023, 11, 21, 15, 9, 39, 758245), DateField(2023, 11, 21, 15, 9, 39, 758262), DateField(2023, 12, 31, 15, 9, 39, 758252)]

number | money

Formats a given number as an amount in the document’s currency. By default, this includes the currency symbol, such as the dollar sign ($), and the correct number of decimals.

{{ 12345.6 | money }}

$1,235.60

number | money(include_symbol: boolean)

Use the include_symbol parameter to format the amount with or without the currency symbol. The default value is True.

{{ 42 | money(include_symbol=False) }}

42.00

number | money(include_code: boolean)

Use the include_code parameter to format the amount to include the ISO 4217 three-letter currency code, such as USD. The default value is False.

{{ 42 | money(include_code=True) }}

€42.00 EUR

number | money(remove_zeros: boolean)

Use the remove_zeros parameter to format the amount without any trailing decimal zeros. The default value is False.

{{ 42.10 | money(remove_zeros=True) }}

€42.1

number | number_to_words

Converts numbers to words in the document language.

{{ 42 | number_to_words }}

forty-two

number | number_to_words(language_code: string)

Use the language_code parameter to specify a language in which the number should be displayed. Use a two-letter language code from this list. The default value is the language code of your document.

{{ 42 | number_to_words(language_code='de') }}

zweiundvierzig

number | number_to_words(format: string)

Use the format parameter to specify the type of the converter to use. Supported values are:

• cardinal (default): Converts the input number to cardinal word form to express quantity.

{{ 1984 | number_to_words(format='cardinal') }}

one thousand, nine hundred and eighty-four

• ordinal: Converts the input number to ordinal word form to express position or rank.

{{ 1984 | number_to_words(format='ordinal') }}

one thousand, nine hundred and eighty-fourth

• ordinal_num: Converts the input number to ordinal number form with the appropriate suffix (e.g., 1st, 2nd, 3rd).

{{ 1984 | number_to_words(format='ordinal_num') }}

1984th

• year: Converts the input number into its word form as a year.

{{ 1984 | number_to_words(format='year') }}

nineteen eighty-four

• currency: Converts the input number into words as a monetary amount. The input number must include decimals.

{{ 1984.00 | number_to_words(format='currency') }}

one thousand, nine hundred and eighty-four euro, zero cents

object | string

Converts an object to a string.

{{ '$' + 42 | string }}

$42

string | tlv(tag: integer)


Encodes string to TLV format. Some QR codes use this format to encode different values.

{{ 'Invoice 1042' | tlv(tag=1) }}

010c496e766f6963652031303432

date | to_timezone(timezone: string)

Converts the datetime to a specified timezone. Use the timezone parameter to specify the timezone as an abbreviation or a full name. The default value is the timezone of your account.

{{ '2024-01-31T13:42:00+00:00' | date | to_timezone('Europe/Bratislava') }}

2024-01-31 14:42:00+01:00

number | abs

Returns the absolute value of a given number.

{{ -42.3 | abs }}

42.3

number | ceil

Rounds up a number to the nearest integer.

{{ 12.34 | ceil }}

13

{{ -12.34 | ceil }}

-12

number | floor

Rounds down a number to the nearest integer.

{{ 12.3456 | floor }}

12

{{ -12.3456 | floor }}

-13

array | max

Returns the largest item from an array.

{{ [1, 2, 3] | max }}

3

array | max(case_sensitive: boolean)

Use the case_sensitive parameter to return the largest item in a case-sensitive manner. Lowercase letters have larger value than uppercase. The default value is False.

{{ ['A', 'b', 'C'] | max(case_sensitive=True) }}

b

array | max(property: string)

Use the property parameter to specify by which property the item with the largest value will be returned. Returns the whole item in which the value is found.

{{ [{'item': 'Red Shirt', 'quantity': 1}, {'item': 'Blue Shirt', 'quantity': 3}] | max(property='quantity') }}

{'item': 'Blue Shirt', 'quantity': 3}

array | min

Returns the smallest item from an array.

{{ [1, 2, 3] | min }}

1

array | min(case_sensitive: boolean)

Use the case_sensitive parameter to return the smallest item in a case-sensitive manner. Uppercase letters have smaller value than lowercase. The default value is False.

{{ ['a', 'B', 'c'] | min(case_sensitive=True) }}

B

min(property: string)

Use the property parameter to specify by which property the item with the smallest value will be returned. Returns the whole item in which the value is found.

{{ [{'item': 'Red Shirt', 'quantity': 1}, {'item': 'Blue Shirt', 'quantity': 3}] | min(property='quantity') }}

{'item': 'Red Shirt', 'quantity': 1}

number | round

Rounds a number to the nearest integer.

{{ 1.23 | round }}

1

{{ -1.23 | round }}

-1

number | round(decimals: integer)

Use the decimals parameter to specify the number of decimal places to round to.

{{ 1.23 | round(decimals=1) }}

1.2

array | sum

Returns the sum of an array of numbers.

{{ [1, 2, 3] | sum }}

6

array | sum(property: string)

Use the property parameter to sum the property values.

{{ document.lines | map(property='quantity') | sum }}

3

array | sum(start: integer)

Use the start parameter to specify a starting number that is added to the sum.

{{ [1, 2, 3] | sum(start=4) }}

10

string | base64_decode

Decodes a string in Base64 format.

{{ 'SW52b2ljZSAxMDQy' | base64_decode }}

Invoice 1042

string | base64_encode

Encodes a value to Base64 format.

{{ 'Invoice 1042' | base64_encode }}

SW52b2ljZSAxMDQy

string | base64_encode_hex

Converts a hex string to Base64 format.

{{ '4865726520626520647261676f6e73' | base64_encode_hex }}

SGVyZSBiZSBkcmFnb25z

string | capitalize

Converts a string so that the first character is uppercase and the rest are lowercase.

{{ 'invoice No 1042' | capitalize }}

Invoice no 1042

string | escape

Replaces the characters &, <, >, ', and " in the string with HTML name codes. Useful to display text that might contain HTML tags.

{{ 'Red <b>bold</b> shirt' | escape }}

Red <b>bold</b> shirt

string | hash(algorithm: string)

Converts a string to a hash. Supports the following algorithms:

• crc32
• sha1
• sha224
• sha256
• sha384
• sha512
• blake2b
• blake2s
• md5
• sha3_224
• sha3_256
• sha3_384
• sha3_512

{{ 'Invoice 1042' | hash(algorithm='md5') }}

6cad15ae3b38fad8afc0ae44651c47ec

string | lower

Converts all characters of a string to lower case.

{{ 'Invoice 1042' | lower }}

invoice 1042

string | pluralize(singular: string, plural: string)

Returns the singular or plural version of a string based on the given parameter.

"{{ 1 | pluralize(singular='item', plural='items') }}

item

"{{ 2 | pluralize(singular='item', plural='items') }}

items

string | remove(remove: string)

Removes the specified part of a string.

{{ 'I can not do it!' | remove(remove=' not') }}

I can do it!

string | replace(old: string, new: string)

Replaces the specified part of a string with a different string.

{{ 'Invoice No 1042' | replace(old='No ', new='#') }}

Invoice #1042

string | replace(old: string, new: string, count: integer)

Use the count parameter to specify how many occurrences will be replaced.

{{ 'Invoice No 1042 - No payment' | replace(old='No ', new='#', count=1) }}

Invoice #1042 - No payment

string | slice(start: integer, length: integer)

Returns the specified part of a string or an array. Specify the first character of the part to be sliced out and the length. The numbering is zero-indexed, meaning the first item of the input has index value 0.

{{ 'Invoice 1042' | slice(start=8, length=4) }}

1042

string | slugify

Converts to lowercase and removes all characters except alphanumeric, underscores, or hyphens. Replaces whitespace characters with hyphens. Strips whitespace characters at the beginning and at the end of a string.

{{ 'Credit note 1042' | slugify }}

credit-note-1042

string | split

Splits a string with whitespace characters as the separator into an array of strings.

{{ 'Invoice No 1042' | split }}

['Invoice', 'No', '1042']

string | split(separator: string)

Use the separator parameter to specify a custom character that will be recognized as the separator.

{{ 'Invoice No: 1042' | split(separator=':') }}

['Invoice No', '1042']

string | strip

Strips whitespace characters at the beginning and at the end of a string.

{{ '  Invoice ' | strip }}

Invoice

string | strip(chars: string)

Use the chars parameter to specify custom characters to be removed at the beginning and at the end of a string.

{{ 'Credit Note' | strip(chars='e') }}

Credit Not

string | strip_html

Removes HTML tags and replaces adjacent whitespace characters with one space.

{{ 'Red <b>bold</b>   shirt' | strip_html }}

Red bold shirt

string | strip_newlines

Removes all newline characters or line breaks from a string.

{{ 'Kyoto
 Lisbon
 Buenos Aires' | strip_newlines }}

Kyoto Lisbon Buenos Aires

string | title

Returns a title case version of the string.

{{ 'invoice no 1042' | title }}

Invoice No 1042

string | truncate(length: integer)

Returns a truncated copy of the string with the specified number of characters. If the string is longer than the specified length, whole words over the limit are cut. The default value is 255.

{{ 'Invoice Number 1042' | truncate(length=10) }}

Invoice…

string | truncate(length: integer, kill_words: boolean)

Use the parameter kill_words to slice the word over the specified length instead of cutting it out whole. The default value is False.

{{ 'Invoice Number 1042' | truncate(length=10, kill_words=True) }}

Invoice Nu…

string | truncate(length: integer, end: string)

Use the end parameter to specify custom ending characters. The default value is an ellipsis sign (…).

{{ 'Invoice Number 1042' | truncate(length=10, end=':::') }}

Invoice Nu:::

string | truncate_words(length: integer)

Returns a truncated copy of the string with a specified number of words.

{{ 'Invoice Number 1042' | truncate_words(length=2) }}

Invoice Number…

string | truncate_words(length: integer, end: string)

Use the end parameter to specify custom ending characters. The default value is an ellipsis sign (…).

{{ 'Invoice Number 1042' | truncate_words(length=2, end=':::') }}

Invoice Number:::

string | upper

Converts all characters of a string to uppercase.

{{ 'Invoice No 1042' | upper }}

INVOICE NO 1042

string | url_encode

Converts a string to URL-safe format by percent-encoding special characters. This ensures that the string can be included in a URL.

https://acmeshop.com/orders/?name={{ 'Order #1042' | url_encode }}

https://acmeshop.com/orders/name=Order%20%231042

string | urlize

Convert URLs in a string to clickable links.

{{ 'View invoices at acmeshop.com/invoices' | urlize }}

View invoices at <a href="https://acmeshop.com/invoices">acmeshop.com/invoices</a>

string | urlize(truncate_length: integer)

Use the truncate_length parameter to shorten the displayed link to a specified length. By default, the whole length is displayed.

{{ 'View invoices at acmeshop.com/invoices' | urlize(truncate_length=12) }}

View invoices at <a href="https://acmeshop.com/invoices">acmeshop.com…</a>

string | urlize(target: string)

Use the target parameter to add target attribute to the link. For example, target='_blank' can be used to open the target page in a new tab.

{{ 'View invoices at acmeshop.com/invoices' | urlize(target='_blank') }}

View invoices at <a href="https://acmeshop.com/invoices" target="_blank">acmeshop.com/invoices</a>