Django-DownloadView provides generic views to make Django serve files.

It can serve files from models, storages, local filesystem, arbitrary URL... and even generated files.

For increased performances, it can delegate the actual streaming to a reverse proxy, via mechanisms such as Nginx’s X-Accel.


In some, serve files managed in a model:

from django.conf.urls import url, url_patterns
from django_downloadview import ObjectDownloadView
from import Document  # A model with a FileField

# ObjectDownloadView inherits from django.views.generic.BaseDetailView.
download = ObjectDownloadView.as_view(model=Document, file_field='file')

url_patterns = ('',
    url('^download/(?P<slug>[A-Za-z0-9_-]+)/$', download, name='download'),

More examples in the demo project!


Several views are provided to cover frequent use cases:

  • ObjectDownloadView to serve some file field of a model.
  • StorageDownloadView to serve files in a storage, without models.
  • PathDownloadView to serve files located on local filesystem, without storage.
  • HTTPDownloadView to proxy some arbitrary URL.
  • VirtualDownloadView to serve in-memory or generated files.

See Download views for details.

Then get increased performances with Optimizations.

Table Of Contents

Next topic

Demo project

This Page