Skip to main contenteBay Playbook
  • Get started
  • Foundations
  • Design system
  • Expressions
  • Resources
  • Articles

Design system

  • Overview
    • Overview
    • Color
    • Dimension
    • Spacing
    • Typography
    • Breakpoints
    • Shadow
    • Shape
    • Opacity
    • Motion
    • Overview
    • Status
    • Accordion
    • Action bar
      • Overview
      • Inline notice
      • Page notice
      • Section notice
    • Avatar
    • Badge
    • Banner
    • Breadcrumb
      • Overview
      • Branded button
      • CTA button
      • Icon button
      • Link button
    • Card
    • Carousel
    • CCD
      • Filter chip
      • Input chip
      • Graphs
      • Metrics
    • Date picker
    • Dialog
    • Divider
    • Education notice
    • EEK rating and range
    • Expansion
      • Checkbox
      • Combobox
      • Dropdown
      • Numeric stepper
      • Password
      • Phone number
      • Radio button
      • Select list
      • Switch
      • Text area
      • Text field
    • Item tile
    • List row
      • Overview
      • Expressive loader
      • Skeleton loader
    • Media container
      • Top navigation bar
    • Pagination
    • Popover
    • Progress stepper
    • Search field
    • Section header
    • Segmented button
      • Overview
      • Context sheet
      • Focus sheet
    • Signal
    • Snackbar
    • Tab
    • Table
      • Tooltip
      • Tourtip
    • Toggle button group
    • Video player
    • Overview
    • Bulk editing
    • File uploading
      • Text link

Phone number

v4.0

The phone number field is a specialized text field enabling quick phone number entry.

  • CSS
  • Marko
  • React
Stylized artwork of a phone number field.
Phone numberv4.0

On this page

  • Considerations
  • Anatomy
  • Properties
  • Behavior
  • Screen sizes
  • Best practices
  • Specs

Anatomy

Properties

Behavior

Screen sizes

Best practices

Specs

PreviousPassword
Things.People.Love.
  • Get started
  • Foundations
  • Design system
  • Expressions
  • Resources
  • Articles
  • About eBay Design
  • Careers
  • Press
  • Privacy policy
© 2026 eBay. All rights reserved.

eBay Evo, the eBay trademark, and the eBay logo are the intellectual property of eBay Inc.

    1. Label
    2. Country dropdown
    3. Helper text
    4. Country code
    5. Value
    6. Field container

    Label

    The label is required for password fields and defaults to “Phone number”. The label can be set to stacked or floating.

    Country code dropdown

    The country code dropdown reveals a list of all supported country codes. The chosen country code updates the formatting applied to the input value.

    Country code value

    The country code value updates according to chosen country code in the dropdown. If a phone number is pasted into the field with the country code included the dropdown will update and the input value formatting will adjust accordingly.

    Input value

    The input value is formatted according to the country code as characters are entered. The value is validated immediately when the field loses focus.

    Value formatting

    The input value is automatically formatted according to the country code selected. This groups the values to make it easier to read and reduce the chance of making errors.

    Country code value

    The country code value is a dynamic text field that updates according to the country selected or the number pasted into the field. Choosing a country from the dropdown updates the country code. Pasting a value will remove the country code from the input value and replace the country code value.

    Small native

    On smaller native screens, the button opens a fullscreen overlay with an indexed list of countries.

    Small web

    On smaller web screens, the button opens a large dialog sheet.

    Medium and large

    On medium and large screens, the dropdown opens a scrollable popover menu. Touch devices reveal a numerical keyboard where possible for the input value.

    Modality

    Do display the country code list in a fullscreen overlay on compact views. This allows for additional features like search and the native index on iOS.

    Don’t display the country code list in a bottom sheet or popover on compact views. This increases the effort required to locate an item and doesn’t support complex interactions like search and index.

    Phone number field diagram with 6 elements numbered: 1. Label, 2. Country dropdown, 3. Helper text, 4. Country code, 5. Value, 6. Field container.
    Two examples of a phone number phone number field. The first shows the label above the field, the second shows the label inside the field.
    A dropdown appears below a phone number field listing country codes: United Kingdom, United States of America, Uruguay, Uzbekistan, and Vietnam.
    ‘+1’ value is shown in the phone number field.
    ‘(234) 567-8900’ value is shown in the phone number field.
    A full phone number ‘+1 (234) 567-8900’ is shown in the phone number field.
    Phone number input field with United Kingdom flag icon and +44 country code.
    Two mobile phone screens; a Payment options screen is shown on the eBay app, with an interaction indicator placed over the flag dropdown in the phone number field. A line connects the interaction indicator to the second screen, which shows a fullscreen overlay with a list of countries and country codes, with a search option on top.
    A large dialogue sheet is featured on the eBay mobile web screen, listing countries with their country codes.
    On a larger eBay Account screen, a dropdown is featured under a phone number field listing countries and their country codes.
    A fullscreen overlay with a list of countries and country codes is shown on the eBay mobile app.
    A bottom half sheet with a list of countries and country codes is shown on the eBay mobile app.
    Phone number field specs are shown. The height of the field container is 48px, the space between the label and field container is 4px, the space between the field container and helper text is 8px, the padding inside of the right side of the field container is 16px, the padding on the right of the country selector is 8px, and the padding on the left and right of the value field is 8px.

    Considerations

    Performant

    Forms allow users to complete fields effortlessly.

    Accessible

    Anyone, no matter their abilities, can complete forms.

    Dynamic

    Forms provide dynamic feedback so users can correct errors quickly and confidently.