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.

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>

Formatting and structure

Use the format [Currency symbol][Value]

• Place the currency symbol ($) in front of the numbers
• Don’t include a space between the currency symbol and the numbers

Currency symbols

• Don’t include currency abbreviations such as USD, AUD, etc. The country site is localized to display the appropriate currency automatically, so these are unnecessary
• Don’t include the cent symbol (¢)
• Don’t 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 changes, place it in front of the currency symbol
• Don’t include a space between the minus or plus sign and the currency symbol