Nunjucks Filters

Filters are essentially functions that can be applied to variables. This document details some of the Nunjucks built-in filters.

Filters are called with a pipe operator (|) and can take arguments. In addition to the filters listed below, you can find many more built-in Nunjucks filters here.

currency

The currency filter formats a number as a monetary amount. It takes the optional, symbol parameter, whose default value is $.

For example:

{{ 100 | currency }} returns $100

{{ 3000 | currency("€") }} returns €3000£"("£

dump

The dump filter dumps an object as a JSON string into the template.

For example:

{{ issue.fields.reporter | dump(2) }} dumps the Reporter user object in "pretty" JSON format, using 2 spaces as indentation.

{{ issue.fields.fixVersions | dump }} dumps the array of Fix Version/s of the issue in un-prettyfied JSON format.

filter

find

first

The first filter gets the first value/object in the array.

For example:

{{ issue.fields.fixVersions | first }} returns the first Fix Version/s object of the issue.

{{ issue.fields.labels | first }} returns the first label of the issue.

join

The join filter returns a string which is a concatenation of strings. 

For example:

{{ issue.fields.fixVersions | join("," , "name") }} joins the names of the Fix Version/s, separated by commas. For example: 1,1.0,2.0

last

The last filter gets the last value/object in the array. 

For example:

{{ issue.fields.components | last }} returns the last component object of the issue.

{{ issue.fields.labels | last }} returns the last label of the issue.

percent

The percent filter formats a number as a percentage. It takes the optional, decimals parameter, whose default value is 0.

 

You are viewing the documentation for Jira Cloud.

On this page

On this page