# django-guardian

Extra authentication backend for Django that grants and checks permissions on individual model objects.


Source: https://findsoftware.frbit.cloud/django-guardian/
Last reviewed: 2026-11-04
Listed since: 2026-11-04

## Record

### Links

- home: https://django-guardian.readthedocs.io/en/stable/
- repository: https://github.com/django-guardian/django-guardian
- docs: https://django-guardian.readthedocs.io/

### Identity

- status: active
- maintainer: The django-guardian Contributors
- maintainerType: community
- parent: unknown
- firstRelease: 2010
- hqCountry: unknown

### Kind

- category: auth
- hosting: python
- language: python
- runtime: python
- runtimeMin: python 3.10
- basedOn: django

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: unknown
- renderingModes: not applicable
- installMethod: uv

### License

- licenseModel: open-source
- license: BSD-2-Clause, CC-BY-4.0

### Releases

- currentMajor: 3
- latestReleaseDate: 2026-10-20

### Adoption

- githubStargazers: 3921
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 165
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 3588
- dependentPackages: 36

### Sources

- urls: https://django-guardian.readthedocs.io/en/stable/ (read 2026-11-04)
- urls: https://api.github.com/repos/django-guardian/django-guardian (read 2026-11-04)
- urls: https://github.com/django-guardian/django-guardian/blob/main/README.md (read 2026-11-04)
- category: https://github.com/django-guardian/django-guardian/blob/main/README.md (read 2026-11-04)
- basedOn: https://django-guardian.readthedocs.io/en/stable/ (read 2026-11-04)
- language: https://api.github.com/repos/django-guardian/django-guardian (read 2026-11-04)
- runtime: https://github.com/django-guardian/django-guardian/blob/3.5.2/pyproject.toml (read 2026-11-04)
- runtimeMin: https://github.com/django-guardian/django-guardian/blob/3.5.2/pyproject.toml (read 2026-11-04)
- installMethod: https://github.com/django-guardian/django-guardian/blob/main/README.md (read 2026-11-04)
- installMethod: https://github.com/django-guardian/django-guardian/blob/main/README.md (read 2026-11-04)
- maintainer: https://github.com/django-guardian/django-guardian/blob/main/LICENSE (read 2026-11-04)
- license: https://github.com/django-guardian/django-guardian/blob/3.5.2/pyproject.toml (read 2026-11-04)
- license: https://github.com/django-guardian/django-guardian/blob/main/LICENSE (read 2026-11-04)
- licenseModel: https://github.com/django-guardian/django-guardian/blob/main/LICENSE (read 2026-11-04)
- firstRelease: https://pypi.org/pypi/django-guardian/json (read 2026-11-04)
- currentMajor: https://api.github.com/repos/django-guardian/django-guardian/releases/latest (read 2026-11-04)
- latestReleaseDate: https://api.github.com/repos/django-guardian/django-guardian/releases/latest (read 2026-11-04)
- githubStargazers: https://api.github.com/repos/django-guardian/django-guardian (read 2026-11-04)
- contributors: https://api.github.com/repos/django-guardian/django-guardian/contributors (read 2026-11-04)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/django-guardian (read 2026-11-04)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/django-guardian (read 2026-11-04)

## Notes

django-guardian is an extra authentication backend that stores permissions on individual model objects and answers checks for them, so a user can hold a permission on one record without holding it on the model. It builds on the object-level permission facilities that Django's authorization system provides. Projects add it to the authentication backends next to Django's default model backend and run the migrations that create its tables.

## Worth knowing

By default Guardian relates permissions to any Django model through generic foreign keys, which has performance implications. The docs point new projects to their performance tuning and configuration pages.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0