https://github.com/jackocnr/intl-tel-input
A JavaScript plugin for entering, formatting and validating international telephone numbers. React, Vue, Angular and Svelte components also included.
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: 1 day ago
JSON representation
A JavaScript plugin for entering, formatting and validating international telephone numbers. React, Vue, Angular and Svelte components also included.
- Host: GitHub
- URL: https://github.com/jackocnr/intl-tel-input
- Owner: jackocnr
- License: mit
- Created: 2013-05-31T21:08:09.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2026-02-04T08:26:37.000Z (8 days ago)
- Last Synced: 2026-02-04T09:39:09.836Z (8 days ago)
- Topics: angular, formatting, input, international-telephone, javascript-plugin, libphonenumber, phone-number, react, reactjs, svelte, typescript, validation, vuejs
- Language: JavaScript
- Homepage: https://intl-tel-input.com
- Size: 73 MB
- Stars: 8,162
- Watchers: 131
- Forks: 2,001
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - jackocnr/intl-tel-input - A JavaScript plugin for entering and validating international telephone numbers. React and Vue components also included. (JavaScript)
- starred-awesome - intl-tel-input - A jQuery plugin for entering and validating international telephone numbers (JavaScript)
README
# International Telephone Input [](https://github.com/jackocnr/intl-tel-input/actions/workflows/ci.yml) 
A JavaScript plugin for entering, formatting and validating international telephone numbers. React, Vue, Angular and Svelte components also included.
[Explore docs »](https://intl-tel-input.com/docs/getting-started)
## 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.
## React, Vue, Angular and Svelte Components
We provide React, Vue, Angular and Svelte (beta) components alongside the regular JavaScript plugin. This readme is for the JavaScript plugin. View the [React Component](https://github.com/jackocnr/intl-tel-input/blob/master/react/README.md), the [Vue Component](https://github.com/jackocnr/intl-tel-input/blob/master/vue/README.md) the [Angular Component](https://github.com/jackocnr/intl-tel-input/blob/master/angular/README.md), or the [Svelte component (beta)](https://github.com/jackocnr/intl-tel-input/blob/master/svelte/README.md).
## Docs and Examples
We have a newly updated website, where you can find [a full set of docs](https://intl-tel-input.com/docs/getting-started.html), 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/validation-practical.html) of different setups.
## Features
* Automatically select the user's current country using an IP lookup
* Automatically set the input placeholder to an example number for the selected country
* Navigate the country dropdown by typing a country's name, or using the up/down keys
* Automatically format the number as the user types
* Optionally, only allow numeric characters and cap the number at the maximum valid length
* The user types their national number, and the plugin gives you the full standardised international number
* Number validation, including specific error types
* High-resolution flag images
* Accessibility provided via ARIA tags
* Typescript type definitions included
* Easily customise styles by overriding CSS variables, e.g. support dark mode
* React, Vue, Angular and Svelte components also included
* Translations provided in over 40 languages, as well as support for RTL layout and alternative numeral sets
* Lots of initialisation options for customisation, as well as instance methods/events for interaction
## 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 