Forms / The visual dictionary

Telephone field.

Accepts a telephone number as text with phone-friendly hints.

Also calledphone fieldtel inputphone number input
01

See it in context

UI illustration

Phone numbers can include country codes, spaces, and punctuation, so a telephone field should not behave like an arithmetic number input. International context helps people choose the right format.

When to use it

Allow international prefixes and common formatting without losing significant digits.

Know the difference

A numeric quantity can be incremented; a phone number is an identifier that must retain its characters.

WebiOSiPadOSAndroidmacOSWindowsLinux

Web

Use a labeled native input and its appropriate type, inputmode, and autocomplete hints. Browser presentation and the available autofill UI vary.

iOS · iPadOS · Android

Choose the keyboard and content type for the value being entered. Keep the field visible above the on-screen keyboard and preserve the user’s selection.

macOS · Windows · Linux

Support ordinary keyboard editing, selection, paste, and undo. A desktop field should not depend on a touch-only accessory keyboard.

Primary documentation for the pattern and its platform conventions.