# Handlebars Helper Function: formatCurrency

The `formatCurrency` helper function formats a number as a currency value.

This function is a convenience function that calls `formatNumber` with the currency format type. It throws an error if the input can't be converted to a number.

## Availability

This helper is available in the Winter ’26 release of Marketing Cloud Next.

## Syntax

```handlebars
{{formatCurrency number cultureCode}}
```

## Parameters

| Parameter     | Type             | Description                                                                                                                                                                                                              |
| ------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `number`      | Number or String | Required. The number to format as a currency value. If the value is a string, it must be convertible to a number.                                                                                                        |
| `cultureCode` | String           | A POSIX locale code for currency formatting, such as `en_US` or `zh-TW`. The operation supports both hyphen (`fr-CA`) and underscore (`fr_CA`) formats. If you don’t specify a culture code, the operation uses `en_US`. |

## Return Value

The operation returns a formatted string representation of the number as a currency value, using the specified locale’s currency format. Different locales use different currency symbols, decimal separators, and grouping patterns. For example, `{{formatCurrency 1234.56 "en-US"}}` returns `$1,234.56`, while `{{formatCurrency 1234.56 "de-DE"}}` returns `1.234,56 €`. Different locales handle the rounding of currency values in different ways. For example, Japanese Yen is usually expressed without decimal places, so `{{formatCurrency 1234.56 "ja-JP"}}` returns `￥1,235`.

If the input can’t be converted to a number, the operation throws an exception. This behavior helps you handle conversion errors gracefully by using the [fallback](/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-fallback.md) helper, as shown in this example.

```handlebars
{{fallback (formatCurrency orderTotal) "Amount not available"}}
```

In this example, if `orderTotal` can’t be converted to a number, the operation returns `Amount not available`.

## See Also

- [fallback](/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-fallback.md)
- [format](/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-format.md)
- [formatNumber](/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-formatnumber.md)