---
schema_version: "1"
id: 65223710461743d1b6afc7e80d0998c2701a20e77d04d08b0c4f7a4f98376928
title: "Handlebars Helper Function: formatCurrency"
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/handlebars/reference/utility/mcn-handlebars-reference-utility-formatcurrency.md
canonical_url: https://developer.salesforce.com/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-formatcurrency.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8f0787134e43668183fcb8e2687fdc8edd783880b2dc172a50b5feb643cb8669
products:
  - Handlebars for Marketing Cloud Next
  - Marketing Cloud
---
# 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](https://developer.salesforce.com/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](https://developer.salesforce.com/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-fallback.md)
- [format](https://developer.salesforce.com/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-format.md)
- [formatNumber](https://developer.salesforce.com/docs/marketing/handlebars-for-marketing-cloud-next/references/mcn-handlebars-utility-references/mcn-handlebars-reference-utility-formatnumber.md)