django-filer

What it is and what it does

Django Filer is a file management application that integrates with Django's admin interface to provide a browsable file and image library. It handles file uploads, organization into folders, and image thumbnails through easy-thumbnails. The package works with django-polymorphic to support flexible file type handling and includes py-svg-hush for SVG processing.

You install it as a Django app, add it to INSTALLED_APPS, and then use its admin interface to browse, upload, and manage files. It's designed for Django CMS but works in any Django project. The package is actively maintained, supports modern Python versions and recent Django versions, and has no known security vulnerabilities.

Use it for:

• Build a Django CMS site with centralized file and image management through the admin interface.
• Add a file picker widget to Django admin forms for selecting previously uploaded images or documents.
• Organize media files into hierarchical folders within a Django project without writing custom storage logic.
• Generate and serve image thumbnails automatically when files are uploaded through Django Filer.
• Manage SVG files safely alongside raster images in a Django application.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Django Filer is a file and image management application for Django that provides a file browser interface and handles file uploads, organization, and retrieval within Django projects.

Yes. Django Filer is a stable, actively maintained production tool with low install friction, no security vulnerabilities, and broad Django version support. It's the standard choice for file management in Django CMS projects and works well in any Django application that needs a user-friendly file browser and upload interface.

Install

django-filer on PyPI

pip install django-filer

uv add django-filer

poetry add django-filer

Installing django-filer

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with recent commits and stable production status across Django versions 3.2 through 6.0.

License in practice

BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; you must include the license text and original copyright notice in distributions.

Quickstart

pip install django-filer

# In settings.py INSTALLED_APPS:
# 'filer',
# 'easy_thumbnails',
# 'polymorphic',

from filer.models import File
file_obj = File.objects.first()

Requires django, django-polymorphic, easy-thumbnails, and py-svg-hush as runtime dependencies.

Verify before relying

• Whether py-svg-hush is a required runtime dependency or an optional security enhancement for SVG handling.
• Specific file size limits or storage backend compatibility constraints beyond the listed dependencies.
• Whether the admin interface customization requires additional Django configuration beyond standard setup.

Package facts

Evidence: django_filer-3.5.0-py3-none-any.whl

Tags

More Software Development packages