PHPackages                             kadegray/statamic-phone-number-fieldtype - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. kadegray/statamic-phone-number-fieldtype

ActiveLibrary[Utility & Helpers](/categories/utility)

kadegray/statamic-phone-number-fieldtype
========================================

Statamic Phone Number Fieldtype Addon

1.0.3(2y ago)1871↓50%1[1 issues](https://github.com/kadegray/statamic-phone-number-fieldtype/issues)JavaScript

Since Apr 2Pushed 2y ago1 watchersCompare

[ Source](https://github.com/kadegray/statamic-phone-number-fieldtype)[ Packagist](https://packagist.org/packages/kadegray/statamic-phone-number-fieldtype)[ RSS](/packages/kadegray-statamic-phone-number-fieldtype/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (5)Used By (0)

Statamic Phone Number Fieldtype
===============================

[](#statamic-phone-number-fieldtype)

> Statamic Phone Number Fieldtype is a Statamic addon that is everything you need to store and display Phone Numbers on your site.

Features
--------

[](#features)

- A Phone Number Fieldtype that uses the [International Telephone Input](https://intl-tel-input.com/).
    - **E164 Format**: Phone numbers will be saved in [E164 format](https://www.twilio.com/docs/glossary/what-e164), the international standard.
    - **Country Selection**: Users can select their country and input phone numbers in the national format for ease of use.
    - **Automatic Country Detection**: When users input a phone number in international format, the corresponding country is automatically selected.
    - Customization Options:
        - **Hide Country Select**: Tailor the user interface by hiding the Country select field if not needed.
        - **Initial Country**: Set a default country for a smoother user experience.
        - **Preferred Countries**: Highlight commonly used countries in the Country select dropdown.
        - **Exclude Countries**: Customize the available country options by excluding specific countries.
        - **Only Countries**: Choose to display only certain countries in the Country select dropdown.
- Modifiers
    - **e164\_to\_national**: Convert E164 formatted phone numbers to the national format.
    - **e164\_to\_international**: Convert E164 formatted phone numbers to the international format.

How to Install
--------------

[](#how-to-install)

You can search for this addon in the `Tools > Addons` section of the Statamic control panel and click **install**, or run the following command from your project root:

```
composer require kadegray/statamic-phone-number-fieldtype
```

How to Use
----------

[](#how-to-use)

### Phone Number Fieldtype

[](#phone-number-fieldtype)

Once you include the Phone Number Fieldtype in your blueprint and edit an entry, it will be presented as an [International Telephone Input](https://intl-tel-input.com/) for convenient input and display.

[![Phone Number Fieldytype in Entry](readme/images/entry_input.png)](readme/images/entry_input.png)

When you open the country select, it will be displayed in the following manner:

[![Phone Number Fieldytype with Countries select open](readme/images/entry_input_countries_select.png)](readme/images/entry_input_countries_select.png)

When a user inputs "2015550123" into the field, the fieldtype will automatically format it into E164 format as "+12015550123", where "+1" represents the country code. The phone number will be saved in E164 format within the entry.

[![Phone Number Fieldytype with number entered](readme/images/entry_input_number_entered.png)](readme/images/entry_input_number_entered.png)

Upon reloading the page after saving the entry, you will observe that the number is automatically formatted in the national format. This formatting behavior is based on the selected country, allowing for proper handling of both international and national numbers.

[![Phone Number Fieldytype with number entered](readme/images/entry_input_displayed_in_national_format.png)](readme/images/entry_input_displayed_in_national_format.png)

#### Fieldtype Configuration

[](#fieldtype-configuration)

When you edit the Fieldtype, you have the ability to configure the following options:

- `Show Country Select` - Enable or disable the display of the Country select.
- `Initial Country` - Set an initial Country.
- `Preferred Countries` - Specify preferred Countries to be displayed at the top in the Countries select.
- `Exclude Countries` - Exclude specific Countries from being shown in the Countries select.
- `Only Countries` - Specify the only Countries to be displayed in the Countries select.

### Modifiers

[](#modifiers)

If you have assigned the field handle as `phone_number` or `australia_phone_number`, you can render the original stored value in E164 format using the following code:

```
{{ phone_number }}
{{ australia_phone_number }}

```

**+12015550123**
**+61412345678**

However, if you prefer to render the number in the national format, you can utilize the `e164_to_national` modifier as follows:

```
{{ phone_number | e164_to_national }}
{{ australia_phone_number | e164_to_national }}

```

**(201) 555-0123**
**0412 345 678**

Additionally, if you would like to present the number in a more visually appealing international format, you can utilize the `e164_to_international` modifier:

```
{{ phone_number | e164_to_international }}
{{ australia_phone_number | e164_to_international }}

```

**+1 201-555-0123**
**+61 412 345 678**

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~16 days

Total

4

Last Release

1086d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/86d4262e84035b3850124b9b5324b9a880e26f190b00de4732106bcf23124130?d=identicon)[kadegray](/maintainers/kadegray)

---

Top Contributors

[![kadegray](https://avatars.githubusercontent.com/u/1983258?v=4)](https://github.com/kadegray "kadegray (7 commits)")

### Embed Badge

![Health badge](/badges/kadegray-statamic-phone-number-fieldtype/health.svg)

```
[![Health](https://phpackages.com/badges/kadegray-statamic-phone-number-fieldtype/health.svg)](https://phpackages.com/packages/kadegray-statamic-phone-number-fieldtype)
```

###  Alternatives

[odolbeau/phone-number-bundle

Integrates libphonenumber into your Symfony application

24910.3M11](/packages/odolbeau-phone-number-bundle)[verbb/formie

The most user-friendly forms plugin for Craft.

101372.9k40](/packages/verbb-formie)[log1x/acf-phone-number

A real ACF phone number field.

12072.5k](/packages/log1x-acf-phone-number)[serendipity_hq/component-value-objects

A set of value objects to manage simple and composite values

20558.6k4](/packages/serendipity-hq-component-value-objects)[rynpsc/craft-phone-number

International phone number field.

2265.9k](/packages/rynpsc-craft-phone-number)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)