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

Text Transformation

uppercase, lowercase, capitalize, titleCase, slugify, camelCase, snakeCase, initials

String Manipulation

trim, truncate, substring, replace, repeat, padStart, padEnd, reverse, removeSpaces

Math Operations

add, subtract, multiply, divide, modulo, power, sqrt, round, ceil, floor, abs, random

Number Formatting

formatNumber, currency, percentage, formatBytes, ordinal

Date & Time

formatDate, formatTime, formatDateTime, now, addDays, daysBetween, monthName, dayName

Comparison

gt, lt, gte, lte, eq, neq

Logic

and, or, not, isEmpty, isNotEmpty, ternary, default

Arrays

first, last, at, join, length, contains, sum, average, max, min

Business

calculateTax, calculateDiscount, netAmount, invoiceNumber, dueDate

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: