jackocnr/intl-tel-input

A JavaScript library for entering and validating international telephone numbers

Maintainers

Package info

github.com/jackocnr/intl-tel-input

Language:TypeScript

pkg:composer/jackocnr/intl-tel-input

Fund package maintenance!

jackocnr

Statistics

Installs: 254 970

Dependents: 3

Suggesters: 0

Stars: 8 191

Open Issues: 1

28.0.4 2026-04-29 18:17 UTC

This package is not auto-updated.

Last update: 2026-04-29 22:08:54 UTC


README

CI version downloads NerdyData.com logo

For entering, formatting, and validating international telephone numbers. Available in vanilla JavaScript, or as React, Vue, Angular, and Svelte components.

Explore docs ยป

intl-tel-input screenshot showing country dropdown open

Sponsored by

Twilio

Use Twilio's API to build phone verification, SMS 2FA, appointment reminders, marketing notifications and so much more. We can't wait to see what you build.

Resources

Check out the website, where you can find a full set of docs, a live playground where you can try out all of the options, as well as plenty of examples of different setups.

Features

๐Ÿ” Fast country picking

  • Search by country name or dial code
  • Full keyboard navigation

โœจ Smart defaults

  • Optionally auto-detect the user's country
  • Example placeholders per country

๐Ÿ“ž Formatting & output

  • Formats the number as the user types
  • Extract standard E.164 numbers to store

๐Ÿ›ก๏ธ Validation

  • Validate numbers with specific error types
  • Only allow valid digits and enforce max length

๐ŸŒ International & accessible

  • Translated into 40+ languages
  • Support for RTL and alternative numerals
  • Screen reader-friendly ARIA markup

๐ŸŽ›๏ธ Developer-friendly

  • Override CSS variables (e.g. dark mode)
  • Extensive initialisation options
  • TypeScript definitions included

Contributing

See the contributing guide for instructions on setting up the project and making changes, and also on how to update the flag images, or how to add a new translation.

Attributions

User testing powered by BrowserStack Open-Source Program

Browser testing via

License

MIT