Skip to main content
Helpers are functions you can use inside your templates to transform and format data. Fileloom includes 70+ built-in helpers organized into categories.

Using Helpers

Call helpers inside Handlebars expressions:
{{! Single argument }}
{{uppercase name}}

{{! Multiple arguments }}
{{currency amount "USD"}}

{{! With string literals }}
{{formatDate date "MMMM D, YYYY"}}

{{! Nested helpers (inner executes first) }}
{{currency (multiply price quantity) "USD"}}

Helper Categories

Quick Reference

Most Used Helpers

HelperExampleResult
currency{{currency 1234.5 "USD"}}$1,234.50
formatDate{{formatDate date "MMM D, YYYY"}}Dec 15, 2024
uppercase{{uppercase "hello"}}HELLO
add{{add 10 5}}15
multiply{{multiply 10 5}}50
formatNumber{{formatNumber 1234567}}1,234,567.00

Combining Helpers

Nest helpers to perform multiple operations:
{{! Calculate and format total }}
{{currency (multiply quantity unitPrice) "USD"}}

{{! Format uppercase date }}
{{uppercase (formatDate date "MMMM")}}

{{! Round then format }}
{{formatNumber (round value 2) 2}}

Helpers in Conditionals

Use comparison helpers with #if:
{{#if (gt total 1000)}}
  <p class="discount">Eligible for bulk discount!</p>
{{/if}}

{{#if (and isPaid (not isRefunded))}}
  <span class="badge">Payment Complete</span>
{{/if}}

{{#if (eq status "active")}}
  <span class="active">Active</span>
{{/if}}

Helpers in Loops

Use helpers inside #each:
{{#each items}}
  <tr>
    <td>{{uppercase this.name}}</td>
    <td>{{formatNumber this.quantity 0}}</td>
    <td>{{currency this.price "USD"}}</td>
    <td>{{currency (multiply this.quantity this.price) "USD"}}</td>
  </tr>
{{/each}}

<tr class="totals">
  <td colspan="3">Total</td>
  <td>{{currency (sum items "price") "USD"}}</td>
</tr>

Next Steps

Explore each helper category for detailed documentation and examples: