Phone numbers

Overview

1. General notes

• Our source language is EN-US (US English)
• Remember to hand off designs to the Localization team
  • Confluence Localization Operations Team / Slack #prj-translations

2. Engineering notes

• We don't (yet) have a library that will localize the format of phone numbers. Features like Intl do not support phone number formatting
• This means phone numbers will likely need to be formatted manually. Use the relevant guidelines shown in this documentation
  

Phone number data

• Follow the local convention for style, punctuation, and sequence

Manually-written EN-US content

• Include 3-digit area code
• Place open and close parentheses before and after area code
• Insert a space after the close parentheses that contains the area code
  • For example, (XXX) XXX-XXXX, (818) 433-5010
• Insert a hyphen after the first 3 digits
  • Tip: The hyphen is the minus sign on your keyboard
• Don't include the country code (1 or +1)
  • Users are on country-specific sites so there's no need to include it

Input fields or error states

When phone numbers appear as part of a <text input field> or an <error state>:

• Go to Components>Forms>Guidelines
• If number needs to be US number, make sure the format matches US phone number format