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:

The preview has been updated.

CopySharePrettify

<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

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

• Write values in numerics, not words (“2” not “two”)
• If a dollar 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