---
id: django-appconf
version: "1.2.0"
license: BSD
license_treatment: permissive
maintenance: aging
---

# django-appconf — A helper class for handling configuration defaults of packaged apps gracefully.

License: permissive · Maintenance: aging · Downloads: 4.8M/mo

## What it is and what it does

django-appconf is a lightweight utility for Django app developers who need to define configuration defaults for reusable packages. It provides an AppConf base class that you subclass to declare your app's settings with default values; the class automatically reads Django's global settings to allow users to override those defaults by setting prefixed variables (e.g., MYAPP_SETTING_1). The package integrates with Django's settings system so that defaults appear in manage.py diffsettings output, and it supports custom prefixes and alternative settings holders via a Meta inner class.

The package solves a common problem in reusable Django apps: avoiding hardcoded settings throughout your code and giving users a clean, discoverable way to customize behavior. It has a single runtime dependency on django and supports Python 3.9 and later, including recent versions through 3.14.

Use it for:

- Define default settings for a reusable Django app that users can override in their project's settings.py without modifying your package code.
- Ensure app configuration defaults show up in Django's diffsettings output for transparency and debugging.
- Centralize app settings in a conf.py module so other modules in your app can import a single settings object with all defaults applied.
- Build a Django package that needs custom setting prefixes or uses a non-standard settings holder instead of django.conf.settings.

## Worth the install?

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

Provides a base class for Django apps to define and manage configuration settings with sensible defaults that can be overridden in Django's global settings.

Yes. django-appconf is stable, permissive-licensed, and solves a real problem for Django app developers. Install friction is minimal. The aging maintenance status (279 days since last release) is not a blocker for a mature utility that has no known vulnerabilities and works with current Django versions (4.2 through 6.0) and Python 3.9+. Use it if you are building a reusable Django app that needs clean configuration defaults.

## Install

pip install django-appconf
uv add django-appconf
poetry add django-appconf

## Installing django-appconf

Before you install: Low friction install with a single runtime dependency on django. Maintenance status is aging—last release was 279 days ago—but the package is marked Production/Stable and the repository remains active and not archived.

License in practice: BSD license is permissive; you can use, modify, and distribute this package freely in both open-source and commercial projects with minimal restrictions.

Quickstart:

pip install django-appconf

from appconf import AppConf

class MyAppConf(AppConf):
    SETTING_1 = "one"
    SETTING_2 = ("two",)

    class Meta:
        prefix = 'myapp'

AppConf classes must be imported during Django startup; placing them in models.py is recommended to ensure they load reliably.

Verify before relying:

- Whether AppConf classes must be placed in models.py or if other guaranteed-load locations work equally well in modern Django versions.

## Package facts

- License: BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 4.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django app configuration defaults, django settings management, reusable django app config, django appconf, django settings prefix, django app settings helper, django-apps, configuration-management

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