django-filer

library3.4.4pypypiunverified

django-filer is an active file management application for Django that simplifies handling of files and images within Django projects. It provides a robust file browser and model fields for seamless integration. The current version is 3.4.4, and the library maintains an active release cadence with frequent updates and patches.

web-framework database

pip install django-filer

github ↗package ↗

INSTALL

IMPORT

SIG · DJANGO-FILER

django-filer

web-frameworkpythonv3.4.4

Install

7.0s avg

Import

—

Disk

115MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.4.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.915 runs

installs and imports cleanly · install 0.0s · import 0.000s · 114.9MB

glibc

py 3.10–3.915 runs

installs and imports cleanly · install 7.0s · import 0.000s · 116MB

115MB installed

● package 115MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FilerImageField

✓ from filer.fields.image import FilerImageField

✗ from filer.fields.image import FilerImageField

To get started with django-filer, install the package, add `filer`, `easy_thumbnails`, `mptt`, and `polymorphic` (if not already present) to your `INSTALLED_APPS` in `settings.py`, and define `MEDIA_ROOT` and `MEDIA_URL`. Then, run migrations. You can then use `FilerImageField` or `FilerFileField` in your Django models, similar to Django's native `ImageField` and `FileField`. Remember to specify an `on_delete` parameter for these fields.

# settings.py INSTALLED_APPS = [ # ... other apps 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'mptt', # Required by easy_thumbnails/polymorphic if not Django-Filer 3.0+ 'easy_thumbnails', 'filer', 'polymorphic', ] MEDIA_ROOT = os.path.join(BASE_DIR, 'media') MEDIA_URL = '/media/' # models.py from django.db import models from filer.fields.image import FilerImageField from filer.fields.file import FilerFileField class Product(models.Model): name = models.CharField(max_length=255) image = FilerImageField(null=True, blank=True, on_delete=models.SET_NULL, related_name="product_images") brochure = FilerFileField(null=True, blank=True, on_delete=models.SET_NULL, related_name="product_brochures") def __str__(self): return self.name

Debug

Known issues

breakingUpgrading from django-filer 2.x to 3.0 drops the dependency on django-mptt. This removes `level`, `lft`, `rght`, and `tree_id` fields from the `Folder` model. Existing data using these fields will need migration handling. Additionally, upload restrictions for HTML and SVG files were introduced.

fix

Run `python manage.py makemigrations filer` and `python manage.py migrate` after upgrading. Review `FILER_FILE_VALIDATORS` settings if you need to allow specific file types. Refer to official upgrade instructions.

affects: 3.0.0+

breakingFrom version 3.3.0, django-filer changed its security policy by default disallowing the upload of binary or unknown file types (e.g., `application/octet-stream`). This was a security measure to prevent malware distribution.

fix

To explicitly allow binary files, add `FILER_REMOVE_FILE_VALIDATORS = ['application/octet-stream']` to your `settings.py`. Consider implementing virus scanning for uploaded files.

affects: 3.3.0+

gotchaPlacing a `FilerFileField` or `FilerImageField` as the very first field in a Django admin form can cause JavaScript errors due to Django's admin trying to set focus on a hidden field.

fix

Ensure that a standard, visible field (e.g., `CharField`) precedes any `FilerFileField` or `FilerImageField` in your admin `fieldsets` or `fields` configuration.

affects: All versions

gotchaSorting logic for files in directory listings was reported to be inconsistent or broken in `3.0.x` versions compared to `2.2.x`, particularly regarding files with and without explicit names.

fix

Review your `FolderAdmin` customizations if you encounter unexpected sorting. You might need to override `get_ordering` or similar methods, or contribute to `django-filer` to address the underlying issue.

affects: 3.0.x

Upgrade

Version history

3.4.4latest on PyPI · released Feb 6, 2026

Audit

Dependencies

DjangorequiredCore framework dependency. Supports Django >= 3.2, 4.2, 5.0, 5.1, 5.2.

django-mpttrequiredRequired for versions < 3.0 for tree structure. Dropped in 3.0.

easy_thumbnailsrequiredUsed for efficient thumbnail generation and image processing.

django-polymorphicrequiredUsed for polymorphic models within filer.

PillowoptionalImage processing library (recommended over PIL). Not a direct pip dependency due to historical installation issues, but functionally required for image features.

Agent activity

25 hits · last 30 days

node

Resources

githubhttps://github.com/django-cms/django-filer ↗

packagehttps://pypi.org/project/django-filer/ ↗