skip to navigation
skip to content

djangoimagestyles 1.0.6

Django image formatting tool.

Simple, fast and easy-to-use tool for pre-rendering images on Django.


  • Renders images and stores them so they don’t need to be re-rendered.
  • Doesn’t modify the original images.
  • Completely independend from other models.
  • Has the following effects (based on Pillow):
  • Crop
  • Enhance
  • Resize
  • Rotate
  • Scale Proportionally
  • Scale by width or height (Smart Scale)
  • Round Corners
  • Render in Templates or via URL
  • Effect Management Utility


Apply to an existing django project: pip install djangoimagestyles Add to installed apps in your project and the MEDIA settings: INSTALLED_APPS = (     ...     image_styles,     ... ) ... MEDIA_URL = '/media/' MEDIA_ROOT = os.path.join(BASE_DIR,'media') Run migrations and the initial data of the module. python migrate You are done! :)


Just to ensure a proper server configuration, if you are prototyping using Django’s runserver, be sure to add the following lines to your my_project/ file as described in the Django 1.8 documentation: ... from django.conf.urls.static import static from django.conf.urls import include from django.conf import settings ... urlpatterns = [    ... ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) It is also recommended to add the '' context processor to the template settings in the my_project/ file to be able to use the {{MEDIA_URL}} tag in your templates: TEMPLATES = [     {         'BACKEND': 'django.template.backends.django.DjangoTemplates',         ...         'OPTIONS': {             'context_processors': [                 ...                 '',             ]         }     } ] > This is only a recommendation since the Django documentation is not that clear about how to do this and people have many different ways of approaching this.

Rendering images via Templates

At the top of your template: “` … {% load image_styles %} …

### Method 1 … {% render_image image ‘Small Thumbnail’ ‘Optional Image Description’ %} … Or you can simply add the ID of the format: … {% render_image image 1 %} … ### Method 2 … … “` ## Rendering images via URL

To add this feature you need to add the path to the ´my_project/´ file like so:

...     url(r'^image_styles/', include('image_styles.urls')), ... Now you can use http://localhost:8000/image_styles/<style id>/<path to your image> to load images with a URL. This feature is VERY useful when dealing with APIs and trying to retreive the correct styled and sized image to a mobile app. This can also be used in a template like this: ... <img src="{% url 'render_image' 1 %}"> ... Where 1 is the style id and image is a django.models.ImageField object.

Rendering images via Views

This is useful when outputting images for API resources.

Import the reverse function at the top of the file. ... from django.core.urlresolvers import reverse ... Finally you can get the image like so: rendered_image = reverse('render_image',[1,]) Where 1 is the style id and image is a django.models.ImageField object.

Default Styles

The module includes 4 simple styles: - Small Thumbnail - a 100px by 100px thumbnail. - Gallery - a 1024px by proportional height image. - Page Header - 1024px by 600px image useful for header backgrounds. - Post Thumbnail - a 250px by 160px thumbnail.

This styles can be edited at any time if you like.

Manage your styles

To crate a style you need to follow the next steps: * As shown in the Rendering images via URL section, you need to add the url(r'^image_styles/', include('image_styles.urls')), path to your root file. * To access the image styles admin interface simply go to http://localhost:8000/image_styles/.

If a style is modified in any way, it will be resetted and the new images will be re-rendered when needed. The admin site is only available for staff users.


  • Since the system has no way of telling if the original images have been deleted or modified, the rendered images can still be shown if the right url is called. The way of preventing this (and the correct thing to do) is to rename the file if the image object has changed.
  • Images with no alpha channels may be filled with a black background.
File Type Py Version Uploaded on Size
djangoimagestyles-1.0.6.tar.gz (md5) Source 2016-03-27 14KB