---
id: django-phonenumbers
version: "1.0.1"
license: BSD License
license_treatment: permissive
maintenance: abandoned
---

# django-phonenumbers — Phone number field for Django admin

License: permissive · Maintenance: abandoned · Downloads: 78.5K/mo

## What it is and what it does

django-phonenumbers is a Django app that adds a PhoneNumberField for models and forms, allowing you to store phone numbers with region-specific validation and formatting. It integrates with Django admin to provide a dedicated phone input widget and uses configurable regex patterns and format strings to display numbers according to regional conventions. The package stores phone numbers as objects with country code, region code, and number components, and provides template filters and tags to format them on display.

However, it has been abandoned since 2015-08-06 and was designed for Django 1.7 and 1.8, making it unsuitable for modern Django projects without significant maintenance or forking.

Use it for:

- Add a phone number field to a Django model with automatic validation and formatting for a specific region.
- Display phone numbers in templates using region-specific formats via the phone_number_format filter.
- Provide a dedicated phone input widget in Django admin with country and region selection.
- Store and retrieve phone numbers with their country code and region code as separate attributes.
- Format phone numbers inline in templates using custom regex patterns and prefix rules.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Django model field and form field for storing, validating, and formatting phone numbers with region-specific patterns and display rules.

No. The package is abandoned (last commit 2015-08-06) and targets Django 1.7 and 1.8, which are over a decade old. Compatibility with modern Django, Python, and phone number standards is not documented and almost certainly broken. Use a maintained alternative instead.

## Install

pip install django-phonenumbers
uv add django-phonenumbers
poetry add django-phonenumbers

## Installing django-phonenumbers

Before you install: Installation is straightforward with no runtime dependencies, but the package is abandoned—last updated 2015-08-06 with no commits since. It was built for Django 1.7 and 1.8, making compatibility with modern Django versions uncertain.

License in practice: Licensed under BSD License (permissive), so commercial and private use are permitted without restriction.

Quickstart:

pip install django-phonenumbers

# In settings.py
INSTALLED_APPS = ['django_phonenumbers', ...]
PHONE_NUMBER_REGION = 'GE'

# In models.py
from django_phonenumbers.models import PhoneNumberField
class MyModel(models.Model):
    phone = PhoneNumberField()

Requires Django 1.7 or 1.8; compatibility with modern Django versions is not documented and likely broken.

Verify before relying:

- Compatibility with Django versions released after 1.8 is unknown.
- Whether the package works with current Python versions despite 'Python 3 :: Only' classifier is unconfirmed.
- Support for modern phone number libraries or standards is unclear given the age of the codebase.
- Whether region-specific formatting actually works as documented for all configured regions.

## Package facts

- License: BSD License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 78.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django phone number field, phone number validation django, international phone formatting, django admin phone input, phone number model field, regional phone format django, phone number storage django, abandoned, legacy-django

[View on SkillFed](https://skillfed.io/packages/django-phonenumbers) · [View on PyPI](https://pypi.org/project/django-phonenumbers/)