django-phonenumber-field/django-phonenumber-field

Health v2 · maintenance only

Adoption not part of the score

1551 stars · 320 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

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

library · maturity stable

form-handling serialization web-development backend developer-tools python django phone-numbers phonenumbers model-fields internationalization

Member repositories

For agents

markdown · JSON · MCP: product_card(name="django-phonenumber-field/django-phonenumber-field")