International Telephone Input

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

Explore docs »

Sponsored by

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

• 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 users to type valid digits and enforce max length

🌍 International & accessible

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

🎛️ Developer-friendly

• Theme it with CSS variables (e.g. dark mode) or utility classes like Tailwind
• TypeScript definitions included

Browser support

All modern browsers: Chrome/Edge 93+, Safari 15.4+, Firefox 92+ (roughly, anything released since early 2022). Need to support something older? See the FAQ.

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

• Flag images from flag-icons
• Original country data from mledoze's World countries in JSON, CSV and XML
• Formatting/validation/example number code from libphonenumber

User testing powered by BrowserStack Open-Source Program

License

MIT