---
id: django-cloudinary-storage
version: "0.3.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# django-cloudinary-storage — Django package that provides Cloudinary storages for both media and static files as well as management commands for removing unnecessary files.

License: permissive · Maintenance: aging · Downloads: 193.7K/mo

## What it is and what it does

Django Cloudinary Storage implements Django's Storage API to route media and static file uploads to Cloudinary instead of local disk. It supports images, raw files (PDFs, text), and videos through separate storage classes, and includes management commands for cleaning up orphaned media and redundant static files. The package wraps the cloudinary SDK and requires minimal configuration—primarily setting Cloudinary credentials and designating a storage class in Django settings.

Once configured, any Django model with ImageField, FileField, or similar will automatically upload to Cloudinary. You can then use Cloudinary's image transformation features (resizing, cropping, format conversion) directly in templates. Static files collected via Django's collectstatic command are hashed and uploaded to Cloudinary's CDN for caching.

Use it for:

- Move user-uploaded images to Cloudinary CDN to reduce server storage and improve delivery speed.
- Serve static assets (CSS, JS, images) from Cloudinary CDN with automatic cache busting via file hashing.
- Store and serve raw files (PDFs, documents) or video files separately from images using specialized storage classes.
- Clean up orphaned media files or redundant static files on Cloudinary using built-in management commands.
- Apply Cloudinary image transformations (resize, crop, format) to uploaded images without server-side processing.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Django with Cloudinary to serve media and static files through Cloudinary's storage API, with management commands for file cleanup.

Yes, if you are running Django 1.8 or later and need to offload file storage to Cloudinary. The install is straightforward and the package is stable for its intended use. However, be cautious: the package has not been updated since 2020-08-23 and may have compatibility issues with modern Django versions. Test thoroughly in your environment before deploying to production.

## Install

pip install django-cloudinary-storage
uv add django-cloudinary-storage
poetry add django-cloudinary-storage

## Installing django-cloudinary-storage

Before you install: Low friction install with only two runtime dependencies (requests and cloudinary). Package is aging—last release was 2020-08-23 and no commits since then—so expect limited maintenance and potential compatibility issues with recent Django versions.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install django-cloudinary-storage

# In settings.py:
INSTALLED_APPS = [
    'cloudinary_storage',
    'django.contrib.staticfiles',
    'cloudinary',
]
DEFAULT_FILE_STORAGE = 'cloudinary_storage.storage.MediaCloudinaryStorage'
CLOUDINARY_STORAGE = {
    'CLOUD_NAME': 'your_cloud_name',
    'API_KEY': 'your_api_key',
    'API_SECRET': 'your_api_secret'
}

Requires Cloudinary account credentials (CLOUD_NAME, API_KEY, API_SECRET) set in settings or environment variables; optional python-magic dependency for video validation.

Verify before relying:

- Compatibility with Django versions released after 2020-08-23 (package has not been updated in several years).
- Whether the package works reliably with current versions of the cloudinary and requests dependencies.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 193.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django cloudinary storage, cloudinary file storage django, django media files cloudinary, cloudinary static files django, django file upload cloudinary, cloudinary cdn django integration, django-storage, cdn-integration, file-management

[View on SkillFed](https://skillfed.io/packages/django-cloudinary-storage) · [View on PyPI](https://pypi.org/project/django-cloudinary-storage/)