Currency

Definition

Currency refers to the representation of monetary values across locales and contexts. Representing currency consistently sets clear user expectations for pricing and payment.

Overview

Localization

Our source language is EN-US (US English). Remember to hand off designs to the Localization team.

Confluence: Localization Operations Team
Slack: #prj-translations

Engineering notes

Use the Intl browser API for localization. This will automatically localize currency into the correct format
Where manually-created content needs to be formatted correctly in the code, use the relevant guidelines shown in this documentation
Below is an example of using the Intl API:

<ul>
  <li>
    Wilkommen! Your order comes to{' '}
    {new Intl.NumberFormat('de-DE', {
      style: 'currency',
      currency: 'EUR',
    }).format(4.56)}
  </li>
</ul>

<ul>
  <li>
    Wilkommen! Your order comes to{' '}
    {new Intl.NumberFormat('de-DE', {
      style: 'currency',
      currency: 'EUR',
    }).format(4.56)}
  </li>
</ul>

Structure

The following guidelines apply to manually written EN-US content. Each country site is localized (reference Engineering notes above) and should use the local convention for style, punctuation and sequence.

Use the format [Currency symbol][Value]

Place the currency symbol ($) in front of the numbers
Do not include a space between the currency symbol and the numbers

Currency symbols

Do not include currency abbreviations such as USD, AUD, etc. The country site is localized to display the appropriate currency automatically, so these are unnecessary
Do not include the cent symbol (¢)
Do not spell out dollars or cents. Use the currency symbol ($) and decimals instead

Values

If an amount is less than 1, insert a 0 before the decimal point
If the cent value is 0, remove the cents completely
- Exception: If the cent value appears inline with other values that do include cents (such as in an invoice or order summary)

Plus or minus (+/-) symbols

If using a plus or minus symbol to show price reductions or additions, place it in front of the currency symbol
Do not include a space between the minus or plus sign and the currency symbol

Examples:

Instead of

20.22$
74.99 US dollars or 74.99 USD or USD74.99
$50.00
¢1
Plus $42.50 or + $42.50

Use

$20.22
$74.99
$50
¢1
+$42.50