Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Django helpers for working with images.

Project Description

Django Image Helper

Provides a model mixin that has 'image' and 'thumbnail' fields.
The uploaded image will be scaled to the model's 'IMAGE_SIZE' and
a thumbnail will be scaled and saved to the model's 'THUMBNAIL_SIZE'.

Additionally, there is an admin mixin to help you display an image's thumbnail
when in the admin's listview.


version 0.1.1
Added AdminImagePreviewWidget. This will show a preview of the image in the
admin change_form view in addition to the link the admin already shows.

To enable, add the following to your ModelAdmin. ::

formfield_overrides = {
SizedImageField: {'widget': AdminImagePreviewWidget},

version 0.1.0
Added SizedImageField. This lets you do the same thing the ``ImageMixin``
was used for, but isolates all the work to the model's field. It should
work with any storage backend.

See the example project for a working sample. The basics:

class MyModel(models.Model):
image = fields.SizedImageField(upload_to="the_directory", size=(500, 500), thumbnail_size=(200, 200))

Then you can access both the image and thumbnail in code or templates by:

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(7.3 kB) Copy SHA256 Hash SHA256
Source None Feb 8, 2018

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers