Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Patterns

Ask users for…

Phone numbers

Use: Deployed
Follow this pattern when you want to ask for a phone number.

Usage

When to use this pattern

  • When you need to collect a phone number. For example, for contact information.

Examples

Phone numbers with country codes

Shows the form fields used to obtain home phone number and mobile phone number with a country code.
Example of asking for a home phone number or mobile phone number with a country code.

Phone numbers without country codes

Shows the form fields used to obtain a phone number with no country code.
Example of asking for an domestic phone number.

How to design and build

Layout details

How this pattern works

  • If possible, tell users why you want their phone number. An example message is: Please enter your contact information so we can get in touch with you if we have questions about your application. This message can be at the top of the page if asking for any other contact information.
  • Validate phone numbers. Users must provide a valid domestic or international phone number.

    Example of acceptable formats for U.S. phone numbers:

    • 703-123-4567
    • 7031234567

    Example of acceptable formats for international phone numbers:

    • +52 123 456-7890
    • 637031234567
  • If a user chooses a home or mobile phone number as their method of contact, phone numbers are required fields. If a user chooses email or mail as their preferred method then a phone number field won’t be validated. (Note: Method of contact field is form dependent)
  • “Mobile phone number” is a required field if the user checks (I would like to receive text messages from VA about my [ ] benefits). An example of this is on the VA Form 22-10203 (Application for Edith Nourse Rogers STEM Scholarship)
  • Pair with email address. Collection of phone numbers is paired with email address. The two patterns typically appear on the same step/page.

Components used in this pattern

Page templates available for this pattern

Use the VADS templates (Patterns & Forms) for Phone numbers in Figma.

Code usage

phonePattern is a web-component pattern available in the Forms library.

Content considerations

  • Do not use primary or secondary phone numbers as headers. Home and mobile phone numbers are more plain language-focused.
  • Display phone numbers in the appropriate way. If you need to display a phone number after it has been collected, then follow content style guidelines on phone numbers.

Labels, error messages, and hint text

Home phone number
Hint text: For international numbers select or enter your country code.
Error type: No entry
Error message: Enter a 10-digit phone number (with or without dashes)
Mobile phone number
Hint text: For international numbers select or enter your country code.
Edit this page in GitHub (Permissions required)
Last updated: May 30, 2025