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 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
• Don't insert any spaces
  • For example, (XXX)XXX-XXXX, (818)433-5010

DO

• (212)867-5309

DON’T

• +1(212)867-5309
• 1.212.867.5309
• 212 867 5309

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