---
id: django-filer
version: "3.5.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# django-filer — A file management application for django that makes handling of files and images a breeze.

License: permissive · Maintenance: active · Downloads: 166.3K/mo

## 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 above — 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

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

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 166.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django file management, django image upload, django file browser, django media library, django file storage, django cms file handling, django asset management, django-app, file-management, cms

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