https://github.com/jackocnr/intl-tel-input
For entering, formatting, and validating international telephone numbers. Available in vanilla JavaScript, or as React, Vue, Angular, and Svelte components.
https://github.com/jackocnr/intl-tel-input
angular formatting input international-telephone javascript-plugin libphonenumber phone-number react reactjs svelte typescript validation vuejs
Last synced: 19 days ago
JSON representation
For entering, formatting, and validating international telephone numbers. Available in vanilla JavaScript, or as React, Vue, Angular, and Svelte components.
- Host: GitHub
- URL: https://github.com/jackocnr/intl-tel-input
- Owner: jackocnr
- License: mit
- Created: 2013-05-31T21:08:09.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2026-05-02T22:54:42.000Z (27 days ago)
- Last Synced: 2026-05-07T03:06:25.938Z (23 days ago)
- Topics: angular, formatting, input, international-telephone, javascript-plugin, libphonenumber, phone-number, react, reactjs, svelte, typescript, validation, vuejs
- Language: TypeScript
- Homepage: https://intl-tel-input.com
- Size: 78.2 MB
- Stars: 8,194
- Watchers: 132
- Forks: 1,997
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- starred-awesome - intl-tel-input - A jQuery plugin for entering and validating international telephone numbers (JavaScript)
- jimsghstars - jackocnr/intl-tel-input - A JavaScript plugin for entering and validating international telephone numbers. React and Vue components also included. (JavaScript)
README
# International Telephone Input
[](https://github.com/jackocnr/intl-tel-input/actions/workflows/ci.yml) 
[](https://badges.nerdydata.com/719de9d2-d0e7-4988-b02f-9f9d52687076/report)
For entering, formatting, and validating international telephone numbers. Available in vanilla JavaScript, or as React, Vue, Angular, and Svelte components.
[Explore docs »](https://intl-tel-input.com/docs/integrations)
## Sponsored by
Use [Twilio's API to build phone verification, SMS 2FA, appointment reminders, marketing notifications and so much more](https://www.twilio.com/blog/international-telephone-input-twilio?utm_source=github&utm_medium=referral&utm_campaign=intl_tel_input). We can't wait to see what you build.
## Resources
Check out the [website](https://intl-tel-input.com), where you can find [a full set of docs](https://intl-tel-input.com/docs/integrations), a [live playground](https://intl-tel-input.com/playground/) where you can try out all of the options, as well as plenty of [examples](https://intl-tel-input.com/examples/vanilla-javascript/validation) 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](https://github.com/jackocnr/intl-tel-input/blob/master/.github/CONTRIBUTING.md) 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
* Flag images from [flag-icons](https://github.com/lipis/flag-icons)
* Original country data from mledoze's [World countries in JSON, CSV and XML](https://github.com/mledoze/countries)
* Formatting/validation/example number code from [libphonenumber](https://github.com/googlei18n/libphonenumber)
User testing powered by [BrowserStack Open-Source Program](https://www.browserstack.com/open-source)
Browser testing via 
## License
MIT