Skip to main content

Django application for image assets management

Project description


Django application for image assets management.

Build Status codecov PyPI version

Use case

  • There are several content types on a web site
  • Each of them has a set of required or additional image assets
  • Every asset of same asset type must satisfy custom constraints on dimensions, format and file size.
  • The most important thing: these constraints and required asset type sets are updated often, along with web design evolves and more platforms are added.


pip install django-image-assets

Working example is in testproject.testapp.

  1. Add image_assets application to installed apps in django settings:

  2. Add generic relation to your content models:

    from django.contrib.contenttypes.fields import GenericRelation
    from django.db import models
    from image_assets.models import Asset
    class Video(models.Model):
        assets = GenericRelation(Asset, blank=True)
  3. Setup inlines for assets

    from django.contrib import admin
    from image_assets.admin import AssetsInline
    from testproject.testapp import models
    class VideoAdmin(admin.ModelAdmin):
        inlines = (AssetsInline,)


  1. Create new asset type (i.e. "thumbnail")
  2. Add Video to allowed_for set: now you can add a thumbnail to a video. Or you may skip this asset.
  3. Add Article to required_for set: now you will able to create or edit an article with valid "thumbnail" asset only.
  4. When an asset is deleted, it's file is owned by DeletedAsset object and may be wiped later by manual or automatic cleanup.


If you need to alter model fields i.e. for AssetType, you may subclass existing model and than change image_assets application settings.

  1. Subclass AssetType model
    from django.db import models
    from image_assets.models import AssetType
    class MyAssetType(AssetType):
        some_feature_flag = models.BooleanField(default=False)
  2. Change a reference to an asset type model in settings:
        'ASSET_TYPE_MODEL': 'my_app.MyAssetType',
        'ASSET_MODEL': 'image_assets.Asset',
        'DELETED_ASSET_MODEL': 'image_assets.DeletedAsset'
  3. image_assets.AssetType will be declared as abstract and MyAssetType will be returned as result of image_assets.models.get_asset_type_model()

Download files

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

Source Distribution

django-image-assets-0.5.0.tar.gz (18.4 kB view hashes)

Uploaded source

Built Distribution

django_image_assets-0.5.0-py3-none-any.whl (26.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page