JavaScript library · npm
libphonenumber-js
Parse, format and validate phone numbers in JavaScript. A smaller rewrite of Google's libphonenumber for browsers and Node.js.
Latest stable
v1.13.15
Released 8 Oct 2026 · 26 days ago
npm install libphonenumber-js@1.13.15yarn add libphonenumber-js@1.13.15pnpm add libphonenumber-js@1.13.15<script src="https://cdn.jsdelivr.net/npm/libphonenumber-js@1.13.15/bundle/libphonenumber-max.js"></script>Install libphonenumber-js 1.13.15
sh
npm install libphonenumber-jssh
yarn add libphonenumber-jssh
pnpm add libphonenumber-jshtml
<script src="https://cdn.jsdelivr.net/npm/libphonenumber-js@1.13.15/bundle/libphonenumber-max.js"></script>Download
- libphonenumber-js-1.13.15.tgznpm package · 952 files · 9.7 MB unpackedDownload
- Checksumssha512-AHdhEQeDFEJ4GKDAQ9Awx…
- libphonenumber-min.jsBrowser bundle, min data (smallest) · jsDelivr CDNOpen
- libphonenumber-max.jsBrowser bundle, max data (all number types) · jsDelivr CDNOpen
- libphonenumber-mobile.jsBrowser bundle, mobile numbers only · jsDelivr CDNOpen
- Browse every filejsDelivr file browser for 1.13.15Browse
- v1.13.15 on GitLabReleaseViewSource .zip
We do not host these files. The links go to the official npm registry and public CDNs.
What changed in 1.13.15
This release updates the phone number metadata to version 9.0.41.
CNIRNGUS
- Updated metadata to version 9.0.41:
- Updated phone metadata for region code(s): CN, IR, NG, US
- Updated short number metadata for region code(s): CN
- Updated carrier data for country calling code(s): 27 (en), 30 (en), 60 (en), 98 (en, fa), 234 (en), 852 (en, zh, zh_Hant)
- Updated / refreshed time zone meta data.
Recent versions
Questions about libphonenumber-js versions
What is the latest version of libphonenumber-js?
The latest stable version of libphonenumber-js is 1.13.15, released on 8 Oct 2026. There have been 461 stable releases in total.
How do I install a specific version of libphonenumber-js?
Add the version after the package name: npm install libphonenumber-js@1.13.15. Yarn and pnpm use the same @version syntax. Every older version has its own page in this directory.
Is there a pre-release or upcoming version of libphonenumber-js?
Yes. Work is under way for the next version. The release radar page lists the evidence and where we found it.
How often is libphonenumber-js released?
Over the last 12 releases the typical gap was 14 days, and there were 33 stable releases in the last year.
Use it in your browser
14 tools built on libphonenumber-js
Each one runs this library in your browser. Nothing you type is uploaded.
- Phone Number ValidatorCheck any phone number, see its country and line type, and copy it as E.164, international or national.
- Phone Number FormatterFormat phone numbers as E.164, international, national or RFC 3966 tel: links. Paste one number or a list.
- E.164 ConverterConvert phone numbers in any style to clean E.164 format for APIs, databases and SMS.
- Phone Number ParserBreak a phone number into country, calling code, national number, extension and line type.
- Bulk Phone ValidatorValidate a list of phone numbers at once and export the valid ones as E.164 or CSV.
- WhatsApp Link GeneratorCreate a wa.me click-to-chat link for any number, with an optional pre-filled message.
- Country Code LookupSearch the international calling code, exit code and trunk prefix of every country.
- Phone Number Length by CountryHow many digits a phone number has in every country, with and without the country code.
- Phone Number Type CheckerCheck whether a number is mobile, landline, VoIP, toll-free or premium rate.
- Phone Number ExtractorPull every phone number out of any text and get a clean E.164 list.
- Phone Number Country CheckerFind out which country a phone number is from, with its flag and calling code.
- Click-to-Call Link GeneratorMake a tel: link and an HTML snippet that starts a call when tapped.
- Phone Number Regex GeneratorCopy a phone number validation regex for any country, with code for JavaScript, Python and PHP.
- libphonenumber-js PlaygroundTry libphonenumber-js online. Type a number and see the exact object it returns, with the code that produces it.
Guides
How to install libphonenumber-jsInstall libphonenumber-js with npm, yarn or a CDN. Compare the min, max and mobile builds with measured bundle sizes, and see TypeScript and import examples.Read the guide libphonenumber-js vs Google libphonenumberHow libphonenumber-js differs from Google's libphonenumber and its ports for Java, Python, PHP, C# and Go. What each one includes and which to pick.Read the guide Format a phone number as the user typesUse the AsYouType class in libphonenumber-js to format phone numbers while typing. Includes a live demo, default country handling and cursor tips.Read the guide