Skip to main content

A Django app for the uploading of large files from the django admin site.

Project description


.. image::

django-admin-resumable-js is a django app to allow you to upload large files from within the django admin site.


.. image::


* pip install django-admin-resumable-js
* Add ``admin_resumable`` to your ``INSTALLED_APPS``
* Add ``url(r'^admin_resumable/', include('admin_resumable.urls')),`` to your
* Add a model field eg: ``from admin_resumable.fields import ModelAdminResumableFileField``


class Foo(models.Model):
bar = models.CharField(max_length=200)
foo = ModelAdminResumableFileField()


* Set ``ADMIN_RESUMABLE_SUBDIR``, default is ``'admin_uploaded'``
* Use upload_to instead of ADMIN_RESUMABLE_SUBDIR
* Set ``ADMIN_RESUMABLE_CHUNKSIZE``, default is ``"1*1024*1024"``
* Set ``ADMIN_RESUMABLE_STORAGE``, default is ``''`` (must be a subclass of ````, or accept the ``location`` init parameter). If you don't want the default FileSystemStorage behaviour of creating new files on the server with filenames appended with _1, _2, etc for consecutive uploads of the same file, then you could use this to set your storage class to something like
* Set ``ADMIN_RESUMABLE_SHOW_THUMB``, default is False. Shows a thumbnail next to the "Currently:" link.


1.0: First PyPI release

1.1: Bug fix [1]

1.2: Django 1.9 Compatibility

2.0: Added upload_to

[1] Django silently truncates incomplete chunks, due to the way the multipart
parser works:
This could result in a file being unable to be uploaded, or a corrupt file,
depending on the situation.


python 3.2 and 3.3 supported up to django 1.8.


python 2.7 supported up to django 1.11

Running Tests Locally

Incomplete notes
[on ubuntu]

sudo apt-get install python3-venv
python3 -m venv venv
source venv/bin/activate
pip install pytest
pip install tox

Thanks to



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-admin-resumable-js-3.0.tar.gz (15.9 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page