# django-phonenumber-field/django-phonenumber-field

A django model and form field for normalised phone numbers using python-phonenumbers

Repository: https://github.com/django-phonenumber-field/django-phonenumber-field
Canonical: https://ross.abutalabs.com/products/django-phonenumber-field
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-15T13:03:53+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 69, longevity 100
- inputs: {"age_days": 5481, "days_push": 18, "days_rel": 44, "gap_med": 111.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1551, forks 320 (observed 2026-08-28T04:05:02.299615+00:00)

## What it is
A Django library providing model and form fields for storing, validating, and formatting international phone numbers, built on top of python-phonenumbers (a port of Google's libphonenumber). It normalizes phone numbers to a canonical format and offers pretty printing and conversion helpers.

## Use cases
- store and validate international phone numbers in Django models
- normalize user-entered phone numbers to E.164 format
- pretty-print phone numbers in national or international format in Django forms
- validate phone numbers per country in Django admin
- convert phone numbers between formats in a Django app

## When to choose
- you have a Django project that needs robust international phone number handling
- you want validation and formatting backed by Google's libphonenumber metadata
- you need normalized storage of phone numbers in the database

## When to avoid
- you are not using Django
- you only need simple phone number storage without validation or normalization
- you need phone number handling outside the Django ORM/forms ecosystem

## Facets
- artifact type: library
- maturity: stable
- function: form-handling, serialization
- domain: web-development, backend, developer-tools
- platform: python
- tags: django, phone-numbers, phonenumbers, model-fields, internationalization

## Member repositories
- django-phonenumber-field/django-phonenumber-field (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:02.299615+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:15.774193+00:00, confidence not recorded.
  - readme: https://github.com/django-phonenumber-field/django-phonenumber-field (fetched 2026-08-28T04:05:02.299615+00:00, sha 189a7f920c0f)
  - registry_pypi: https://pypi.org/pypi/django-phonenumber-field/json (fetched 2026-08-29T11:30:43.732968+00:00, sha 243be778d641)
- Data as of 2026-08-30T08:39:29.467469+00:00.