PyPI · #2835 most downloaded on PyPI

cloudinary

1.46.22.7M downloads/mocloudinary/pycloudinary ↗New releases in your daily digest, changelog included.

Upload, transform, optimize, and manage images and videos with Cloudinary from Python or Django.

Last release 21 days ago
27 Aug 2026
Release timing varies
gaps range from 8 days to 10 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
95 releases · first in 2012

Release timeline

95 releases since 2012

2012201420162018

Releases

1.3.018 Jan 2016
Support line spacing in text overlay
Archive generation support

Support line spacing in text overlay

Put uploader params in multipart body rather than url

Support responsive_breakpoints parameter

Update static assets based on new cloudinary_js repository structure.

Allow saving and retrieving cloudinary field without version

Fix default resource type handling when saving models
Open source →
1.2.01 Nov 20152 sources agree
Merge pull request #60 from nloadholtes/nloadholtes_python3
Merge pull request #60 from nloadholtes/nloadholtes_python3

Support easy overlay/underlay construction

Skip test_restore and test_upload_mapping if no api_key/api_secret

Support upload_mappings api

Support restore api

Support 'invalidate' in rename and 'invalidate' and 'context' in explicit

Support aspect ratio transformation param

Adding double quotes to prevent python 2.x from printing empty parens

Adding parens to print for python 3 compatibility

Merge pull request #59 from nloadholtes/patch-1

Doc update

Merge pull request #58 from netman92/patch-1

Fixed typo in readme.md

Merge pull request #46 from rtrajano/master

Merge branch 'ZeroCater-master'

get_prep_value returns default instead of None

Added len function to CloudinaryImage

Add version script

1.1.222 Jun 2015

Update USER_AGENT format and allow the setting of USER_PLATFORM

Update USER_AGENT format and allow the setting of USER_PLATFORM
Remove max_length restriction from CloudinaryField
Reformat CHANGES.txt and rename it to CHANGELOG.md
Change PyPI package classifier to "Development Status :: 5 - Production/Stable"

Open source →

Additional notes

Update USER_AGENT. Remove max_length restriction from CloudianryField. Rename and reformat CHANGES.txt. * Version 1.1.2 * Update USER_AGENT format and allow the setting of USER_PLATFORM * Remove max_length restriction from CloudinaryField * Reformat CHANGES.txt and rename it to CHANGELOG.md * Change PyPI package classifier to "Development Status :: 5 - Production/Stable"

Open source →

1.1.07 Apr 2015

Increment to v1.1.0 - Support saving non-image resource types in CloudinaryField. Support storing type information in database. Support video tag and

Increment to v1.1.0 - Support saving non-image resource types in CloudinaryField. Support storing type information in database. Support video tag and video thumbnail generation. Support video transformation parameters. Support eager_notification_url and eager_async in explicit. Support ftp urls in upload. upload large enhancements. Python3 compatibility fixes.
- Make context check more resilient
- Python3 compat for cloudinary_direct_upload_field
- Fix video public_id cleansing pattern
- Endpoint upload_chunked is no longer needed
- Solve Python3 compatiblity issues
- Support html attributes in video tag
- upload large - test exact size
- Simplify URL detection RE in uploader
- Fix references to CloudinaryImage
- Support new upload_chunked endpoint for large uploads. Fix random_public_id.
- Support ftp urls in upload
- Support eager_notification_url and eager_async in explicit
- Support video tag and video thumbnail generation
- Support saving non-image resource types in CloudinaryField. Support storing type information in database
- Support video transformation parameters
- signed_preloaded_image - allow integer version

Open source →

1.0.1921 Dec 2014

Increment version to v1.0.19: Folder listing. Support tags in upload_large. URL suffix, root URL and secure domain sharding. Support invalidate in bul

Increment version to v1.0.19: Folder listing. Support tags in upload_large. URL suffix, root URL and secure domain sharding. Support invalidate in bulk delete. GAE support. Allow uploader.upload_image to work on raw files. Support return_delete_token flag in upload. Support custom_coordinates in upload, explicit and update, coordinates flag in resource details. Update jQuery plugin to v1.0.21.
- invalidate in bulk delete
- folder listing. tags in upload_large, url suffix and root ur and secure domain sharding
- add support for GAE. add sample GAE
- Allow uploader.upload_image to work on raw files
- Support return_delete_token flag in upload
- Support custom_coordinates in upload, explicit and update, coordinates flag in resource details

Open source →

1.0.187 Jul 2014

Increment version to v1.0.18: Support for density pixel ratio (dpr) transformation parameter. Support auto width, auto dpr and responsive width. Suppo

Increment version to v1.0.18: Support for density pixel ratio (dpr) transformation parameter. Support auto width, auto dpr and responsive width. Support for background_removal parameter in upload and update. Upgrade jQuery plugin to v1.0.18. Support timeouts in API requests. Fix return_error mode when calling api. Allow user to override secure setting. Replace Exception with ValueError. Support auto-securing URLs if django request is enabled and the current page is being served over HTTPS.
- Fix tests to reflect prefix + direction=desc is not supported
- Support for background_removal parameter in upload and update
- Support width auto, dpr auto and responsive width
- Fix return_error mode when calling api
- Merge pull request #35 from ndparker/master
- Merge pull request #34 from MatthiasEgli/master
- add the possibility to add timeouts to api requests
- added transformation option DPR
- Merge pull request #33 from Tekco/master
- Allow user to override secure setting.
- Added support for auto-securing URLs if django.core.context_processors.request is enabled and the current page is being served over HTTPS according to request.is_secure().
- Issue #32 - Replace Exception with ValueError

Open source →

1.0.1729 Apr 2014

Increment to version 1.0.17: Support upload_presets. Support unsigned uploads. Support start_at for resource listing. Support phash for upload and res

Increment to version 1.0.17: Support upload_presets. Support unsigned uploads. Support start_at for resource listing. Support phash for upload and resource details. Support for passing filename to upload_options. Use index of version_info tuple rather than named (added in 2.7). Added introspection rule for Django South. Allow using module when django is available but not configured. Update jQuery library to v1.0.14.
- Issue #30 - allow using module when django is available but not configured
- Support upload_presets. Support unsigned uploads. Support start_at for resource listing. Support phash for upload and resource details
- Support for passing filename to upload_options
- Merge pull request #29 from Tekco/master
- Added introspection rule for Django South
- Use index of version_info tuple rather than named (added in 2.7)

Open source →

1.0.1526 Feb 2014

Increment to version 1.0.15: Admin API update method. Admin API listing by moderation kind and status. Support moderation status in admin API listing.

Increment to version 1.0.15: Admin API update method. Admin API listing by moderation kind and status. Support moderation status in admin API listing. Support moderation flag in upload. New upload and update API parameters: moderation, ocr, raw_conversion, categorization, detection, similarity_search and auto_tagging. Support uploading large raw files.
- Support for update admin API. Support new moderations and resource info requests. Support uploading large raw files.

Open source →

1.0.1411 Feb 2014

Increment to version 1.0.14: Embedding the external poster package to avoid pip 1.5.x errors. Add support for direction in resource listing.

Increment to version 1.0.14: Embedding the external poster package to avoid pip 1.5.x errors. Add support for direction in resource listing.
- add support for direction in resource listing. fix resource listing tests. add very basic sample Flask project.
- skip delete all derived test by deault

Open source →

1.0.139 Jan 2014

Increment to version 1.0.13: Support overwrite upload parameter. Support tags in admin API resource listing. Support specifying face coordinates in up

Increment to version 1.0.13: Support overwrite upload parameter. Support tags in admin API resource listing. Support specifying face coordinates in upload API. Support specifying context (currently alt and caption) in upload API and returning context in API. Support specifying allowed image formats in upload API. Support listing resources in admin API by multiple public IDs. Send User-Agent header with client library version in API request. Support for signed-URLs to override restricted dynamic URLs. Use api.Error instead of Exception in uploader module. Support deleting all resources in Admin API.
- add user agent
- support for: context, allowed_formats, face_coordinates, signed_url, search by public ids, context and tags in lists
- Merge pull request #24 from stylight/master
- uploader module: Use api.Error instead of Exception
- add delete_all_resources, add support for overwrite flag in upload, add support for tags flag in resources_by_tag, add support for query parameters in CLOUDINARY_URL

Open source →

1.0.124 Nov 2013

Increment to version 1.0.12: CloudinaryJsFileField - Handle validation errors in form by redering hidden field with previous upload result. Support un

Increment to version 1.0.12: CloudinaryJsFileField - Handle validation errors in form by redering hidden field with previous upload result. Support unique_filename. Support color transformation parameter.
- CloudinaryJsFileField - Handle validation errors in form by redering hidden field with previous upload result
- add support unique fiename and correctly handle boolean upload parameters
- Support color transformation parameter

Open source →

1.0.107 Aug 2013

Increment version to v1.0.10: Support ping to Admin API, Support folder and proxy upload parameters, Escape non-http public_ids. Correct escaping of s

Increment version to v1.0.10: Support ping to Admin API, Support folder and proxy upload parameters, Escape non-http public_ids. Correct escaping of space and '-'.
- Escape non-http public_ids. Correct escaping of space and -
- Support folder and proxy upload parameters
- Support ping to Admin API

Open source →

1.0.81 Jul 2013

Increment version to v1.0.8: Issue #18 - Support for other types in addition to 'upload', Fixed issue where a parameter may not be set to 0, Fixed bug

Increment version to v1.0.8: Issue #18 - Support for other types in addition to 'upload', Fixed issue where a parameter may not be set to 0, Fixed bug with a couple ivars not being set in init, Support discard_original_filename, Support s3 and data:uri urls, Support for zip_download_url. Cleanup of signing code.
- Support for zip_download_url. Cleanup of signing code
- Support s3 and data:uri urls
- Support discard_original_filename
- Merge pull request #22 from spothero/master
- Fixed bug with a couple ivars not being set in init.
- Merge pull request #20 from spothero/master
- quick fix.
- Fixed issue where a parameter may not be set to 0.
- Issue #18 - Support for other types in addition to 'upload'
- Updating readme to link to samples

Open source →

1.0.71 May 2013

Increment version to v1.0.7: Add metadata to CloudinaryImage in upload. Support CloudinaryImage in the cloudinary_url templatetag. Invalidate flags in

Increment version to v1.0.7: Add metadata to CloudinaryImage in upload. Support CloudinaryImage in the cloudinary_url templatetag. Invalidate flags in upload and destroy. Private download link generator. Shorten URL support. Support for folders. Support unsafe transformation update. Support rename
- Fix handling of url_options in CloudinaryImage
- Add metadata to CloudinaryImage in upload
- Support CloudinaryImage in the cloudinary_url templatetag
- Invalidate flags in upload and destroy
- Private download link generator
- Shorten URL support
- Support for folders
- Basic sample: not running cleanup in default, minor text changes
- Merge branch 'fixes' of https://github.com/m0she/pycloudinary
- Support unsafe transformation update
- Support rename
- sample/basic - Add documentations
- sample/basic - make more first-time-user-friendly
- Minor merge before release
- Merge branch 'master' of github.com:cloudinary/pycloudinary
- Issue #15 - Support blank=True in CloudinaryField

Open source →

1.0.625 Mar 2013

Increment version to v1.0.6: Support Django 1.5, Add cloudinary_direct_upload_field, cloudinary_js_config, cloudinary_url templatetags, Add basic samp

Increment version to v1.0.6: Support Django 1.5, Add cloudinary_direct_upload_field, cloudinary_js_config, cloudinary_url templatetags, Add basic sample, Update documentation
- version 1.0.5
- Django 1.5 support
- Update documentation
- add cloudinary_direct_upload_field and cloudinary_js_config templatetags
- cloudinary templatetag - accept an options_dict arg
- add cloudinary_url templatetag, fix build_url and image in CloudinaryImage
- CloudinaryField - support image without format
- samples/basic - add cleanup
- samples - create basic sample

Open source →

1.0.412 Mar 2013

Increment version to v1.0.4: Fix tag handing methods of api, Support for sprite, multi and explode apis. Support for new async and notification params

Increment version to v1.0.4: Fix tag handing methods of api, Support for sprite, multi and explode apis. Support for new async and notification params, Support for usage API call, Support js files needed for client side image processing in jquery direct upload, Support new image_metadata flag in upload and admin API, Use width/height even if crop is not given
- Fix tag handing methods of api
- Support for sprite, multi and explode apis. Support for new async and notification params
- Support for usage API call
- Fix whitespace issues after merge
- Merge branch 'b1'
- Support js files needed for client side image processing in jquery direct upload
- Support new image_metadata flag in upload and admin API
- Use width/height even if crop is not given
- Fixing indentation
- Fixing indentation

Open source →

1.0.028 Oct 2012

Increment version to v1.0.0: Renamed url method of CloudinaryImage to build_url to avoid conflicts with the url property. Support keep_original in res

Increment version to v1.0.0: Renamed url method of CloudinaryImage to build_url to avoid conflicts with the url property. Support keep_original in resource deletion. Support delete_resources_by_tag, Allow supplying unicode url in cloudinary.uploader.upload, Support passing parameters to cloudinary upload. Support upload parameters based on model in CloudinaryField, Support for transformation flags.
- Support for transformation flags
- Merge branch 'master' of github.com:cloudinary/pycloudinary
- Support passing parameters to cloudinary upload. Support upload parameters based on model in CloudinaryField
- Allow supplying unicode url in cloudinary.uploader.upload
- Support delete_resources_by_tag Support keep_original in resource deletion

Open source →

0.2.88 Oct 2012

Increment version to v0.2.8: Change delete_resources_by_prefix to match other signatures, Support max_results in resource drilldown, Support for borde

Increment version to v0.2.8: Change delete_resources_by_prefix to match other signatures, Support max_results in resource drilldown, Support for border and delay.
- Change delete_resources_by_prefix to match other signatures
- Support max_results in resource drilldown
- Support for border and delay

Open source →

0.2.72 Oct 2012

Increment version to v0.2.7: Support cname, Support headers. Support format in eager. Support explicit. Support type in tags. Support unicode in Cloud

Increment version to v0.2.7: Support cname, Support headers. Support format in eager. Support explicit. Support type in tags. Support unicode in CloudinaryImage.image. Depend on Django staticfiles module only if CloudinaryJsFileField is used with callback support. Fix to to_python error for submitting blank file.. Pass new flags to resource information api.
- Pass new flags to resource information api
- egg fix
- fix new version
- fix to to_python error for submitting blank file
- Merge branch 'master' of github.com:cloudinary/pycloudinary
- Depend on Django staticfiles module only if CloudinaryJsFileField is used with callback support
- Support unicode in CloudinaryImage.image
- Support headers. Support format in eager. Support explicit. Support type in tags
- Support cname

Open source →

0.2.627 Aug 2012

Increment version to v0.2.6: Wrapper for Cloudinary management API, Better integration with JS library for direct uploads, Allow supplying default for

Increment version to v0.2.6: Wrapper for Cloudinary management API, Better integration with JS library for direct uploads, Allow supplying default formfield for CloudinaryField model field, Do not pass width/height to html in case of crop fit or limit and in case of angle.
- Do not pass width/height to html in case of crop fit or limit and in case of angle
- Allow supplying default formfield for CloudinaryField model field
- Helper method to initialize callback for IE CORS support
- Better integration with JS library. Fix CloudinaryJsFormField
- Wrapper for Cloudinary management API

Open source →

0.2.527 Jul 2012

Increment version to v0.2.5: Fix case in which Django is in python path but not used, Support density and page. Support http public ids in non-fetch t

Increment version to v0.2.5: Fix case in which Django is in python path but not used, Support density and page. Support http public ids in non-fetch types (e.g. vimeo)
- Merge branch 'master' of github.com:cloudinary/pycloudinary
- Support density and page. Support http public ids in non-fetch types (e.g. vimeo)
- Fix case in which Django is in python path but not used

Open source →

0.2.212 Jul 2012

Increment version to v0.2.2: Allow saving an CloudinaryField assigned with CloudinaryImage with no format and version

Increment version to v0.2.2: Allow saving an CloudinaryField assigned with CloudinaryImage with no format and version
- Allow saving an CloudinaryField assigned with CloudinaryImage with no format and version
- Updating readme to show pip install notes
- Renaming package to 'cloudinary'
- More config changes
- Configuration changes for packaging
- Support backup flag for uploads
- Underlay support. Don't pass width/height to html if overlay/underlay are used
- Integration with cloudinary JS library for direct upload to cloudinary
- CloudinaryFileField which allows easy upload via the server
- Support effect parameter. Rename effects to effect to avoid confusion
- Merge branch 'master' of github.com:cloudinary/pycloudinary
- Fetch format and effects parameters support
- Update README.md
- Markdown fixes

Open source →