Template helpers

PDFox provides a curated set of built-in Handlebars helpers. Custom helpers are not supported — transform data server-side before passing it as data if you need custom logic.

Formatting

HelperExampleOutput
formatCurrency{{formatCurrency amount "GBP"}}£1,200.00
formatDate{{formatDate iso}}17 May 2026
formatNumber{{formatNumber qty 0}}1,235
uppercase{{uppercase name}}ACME LTD
lowercase{{lowercase name}}acme ltd
default{{default reference "N/A"}}Fallback if value is falsy
percent{{percent rate 1}}12.3%

Arithmetic

HelperExampleOutput
add{{add subtotal tax}}Sum of two numbers
subtract{{subtract total discount}}Difference of two numbers
multiply{{multiply qty price}}Product of two numbers
divide{{divide total count}}Quotient of two numbers

Comparison (use inside {{#if}})

HelperExampleMeaning
eq{{#if (eq status "paid")}}Strict equality
neq{{#if (neq type "draft")}}Not equal
gt{{#if (gt total 0)}}Greater than
gte{{#if (gte qty 10)}}Greater than or equal
lt{{#if (lt qty 10)}}Less than
lte{{#if (lte balance 0)}}Less than or equal
AI agents can call list_template_helpers via MCP to get this list along with runnable examples — no need to hard-code it into prompts.