Use cloudinary within wagtail
This project is still maintained, but I prefer this approach instead now https://gitlab.com/thelabnyc/wagtail-cloudinary-image
About
This package adds Cloudinary support to Wagtail CMS
Installation
pip install wagtailcloudinary
Wagtail 2.4 and Django 2.1 are supported.
Configuration
Add app wagtailcloudinary in your INSTALLED_APPS list. Also add cloudinary if not already done.
INSTALLED_APPS = [
...
'cloudinary',
'wagtailcloudinary',
...
]
in settings.py put your cloud_name, api_key and apy_secret into cloudinary configuration
import cloudinary
cloudinary.config(
cloud_name=<YOUR_CLOUDINARY_CLOUD_NAME>,
api_key=<YOUR_CLOUDINARY_API_KEY>,
api_secret=<YOUR_CLOUDINARY_API_SECRET>,
)
Next edit your urls.py like this:
from wagtailcloudinary import site
urlpatterns = [
...
url(r'^wagtailcloudinary', include(site.urls, namespace="wagtailcloudinary")),
...
]
Usage
in models.py
from wagtail.wagtailadmin.edit_handlers import FieldPanel
from wagtail.wagtailcore.models import Page
from wagtailcloudinary.fields import CloudinaryField
from wagtailcloudinary.widgets import AdminCloudinaryChooser
class SomePage(Page):
image = CloudinaryField()
content_panels = Page.content_panels + [
FieldPanel('image', widget=AdminCloudinaryChooser),
]
Or use in a streamfield
from wagtailcloudinary.blocks import CloudinaryImageBlock
2 maintainers
Release files for wagtailcloudinary 2.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| wagtailcloudinary-2.3.0.tar.gz | 490.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wagtailcloudinary-2.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 508.5 kB
Release files / wagtailcloudinary-2.3.0.tar.gz
| Download URL | wagtailcloudinary-2.3.0.tar.gz |
|---|---|
| Size | 490.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5959e3454cadf270f9baeb7739ab0098189dc3da388897b8000f594fb542d4b
|
|
BLAKE2b-256 checksum How to use checksums |
1900ecaa9d63a0d7b3b5ee6789d2b19e6f60eb1e2046163c772301ee42649073
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.3
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitLab CI/CD, verified by PyPI on Sep 3, 2025.
Transparency logRelease files / wagtailcloudinary-2.3.0-py3-none-any.whl
| Download URL | wagtailcloudinary-2.3.0-py3-none-any.whl |
|---|---|
| Size | 18.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
845c6385e5bc121f215afb2115395d4c11896fa3fe3599df8c42a5afbeb479d4
|
|
BLAKE2b-256 checksum How to use checksums |
ce2b2cde8370a6bd23cc754572acb51bcb1c68e5e341fd2ca14c73471f23fa05
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.3
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitLab CI/CD, verified by PyPI on Sep 3, 2025.
Transparency log
