PHPackages thomasvantuycom/craft-cloudinary - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. thomasvantuycom/craft-cloudinary ActiveCraft-plugin thomasvantuycom/craft-cloudinary ================================ Cloudinary integration for Craft CMS. 2.2.3(4mo ago)43064MITPHPPHP ^8.2CI passing Since Jul 18Pushed 4mo ago2 watchersCompare [ Source](https://github.com/thomasvantuycom/craft-cloudinary)[ Packagist](https://packagist.org/packages/thomasvantuycom/craft-cloudinary)[ GitHub Sponsors](https://github.com/thomasvantuycom)[ RSS](/packages/thomasvantuycom-craft-cloudinary/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (6)Versions (23)Used By (0) Cloudinary for Craft CMS ======================== [](#cloudinary-for-craft-cms) This plugin integrates [Cloudinary](https://cloudinary.com/) with [Craft CMS](https://craftcms.com/). Assets can be uploaded from Craft's control panel and then transformed and delivered by Cloudinary, even if stored in a different filesystem. The plugin is compatible with your existing Craft template code and named image transforms. Requirements ------------ [](#requirements) This plugin requires Craft CMS 5.0.0 or later, and PHP 8.2 or later. Installation ------------ [](#installation) You can install this plugin from the Plugin Store or with Composer. #### From the Plugin Store [](#from-the-plugin-store) Go to the Plugin Store in your project’s Control Panel and search for “Cloudinary”. Then press “Install”. #### With Composer [](#with-composer) Open your terminal and run the following commands: ``` # go to the project directory cd /path/to/my-project.test # tell Composer to load the plugin composer require thomasvantuycom/craft-cloudinary # tell Craft to install the plugin ./craft plugin/install cloudinary ``` Setup ----- [](#setup) The plugin adds a Cloudinary filesystem type to Craft. It can be used solely as a transform filesystem or as a storage filesystem as well. To create a new Cloudinary filesystem to use with your volumes, visit **Settings** → **Filesystems**, and press **New filesystem**. Select “Cloudinary” for the **Filesystem Type** setting and configure as needed. To start using the filesystem, visit **Settings** → **Assets** → **Volumes**. Here you can create a new volume using the Cloudinary filesystem for both storage and transforms, or add the Cloudinary filesystem to any existing volumes for transforms only. In the latter case, any assets with public URLs from any local or remote filesystem are transformed by Cloudinary using the [fetch feature](https://cloudinary.com/documentation/fetch_remote_images#fetch_and_deliver_remote_files). This may not work in local development setups. Image Transformations --------------------- [](#image-transformations) The plugin supports all of [Craft's native transform options](https://craftcms.com/docs/4.x/image-transforms.html). These can be found under **Settings** → **Assets** → **Image Transforms**. In addition, you can incorporate any of [Cloudinary's transformation options](https://cloudinary.com/documentation/transformation_reference#overview) in the transforms you define in your templates, like so: ``` {% set thumb = { width: 100, height: 100, quality: 75, opacity: 33, border: '5px_solid_rgb:999', } %} ``` Transformation options should be in camelCase, meaning `aspect_ratio` becomes `aspectRatio`, or `fetch_format` becomes `fetchFornat`. Webhook notifications --------------------- [](#webhook-notifications) To keep Craft aligned with changes made directly in Cloudinary, activate webhook notifications. Simply go to your [Cloudinary settings](https://console.cloudinary.com/settings/c-4547d495209fcc884b171f78858f04/webhooks) and add a new notification URL. Point it to the base URL of your website followed by `/actions/cloudinary/notifications/process?volume={VOLUME_ID}`. Remember to replace `{VOLUME_ID}` with the relevant asset volume ID, which you can find in the URL of the volume's settings page. Enable the relevant notification types: `upload`, `delete`, `rename`, `create_folder`, `delete_folder`, and—if relevant to your environment—`move` and `move_or_rename_asset_folder`. Keep in mind, this setup only functions in local development if your local domain is publicly accessible via a service like ngrok. Additionally, note that the webhook may struggle with a large volume of operations. If you frequently make extensive changes in the Cloudinary Console, consider re-indexing your asset volume instead. ### Health Score 46 — FairBetter than 93% of packages Maintenance74 Regular maintenance activity Popularity21 Limited adoption so far Community10 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~44 days Recently: every ~140 days Total 21 Last Release 142d ago Major Versions 1.7.1 → 2.0.02024-05-30 1.7.2 → 2.2.02025-02-01 PHP version history (2 changes)1.0.0PHP >=8.0.2 2.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/adb88658036208affd371b76b342a46d6f7e201fb8d97a6e817857d792bb27aa?d=identicon)[thomasvantuycom](/maintainers/thomasvantuycom) --- Top Contributors [![thomasvantuycom](https://avatars.githubusercontent.com/u/107400578?v=4)](https://github.com/thomasvantuycom "thomasvantuycom (48 commits)") ### Embed Badge ![Health badge](/badges/thomasvantuycom-craft-cloudinary/health.svg) ``` [![Health](https://phpackages.com/badges/thomasvantuycom-craft-cloudinary/health.svg)](https://phpackages.com/packages/thomasvantuycom-craft-cloudinary) ``` ### Alternatives [spicyweb/craft-neo A Matrix-like field type with block hierarchy 395798.1k10](/packages/spicyweb-craft-neo)[nystudio107/craft-seomatic SEOmatic facilitates modern SEO best practices & implementation for Craft CMS 5. It is a turnkey SEO system that is comprehensive, powerful, and flexible. 1741.4M46](/packages/nystudio107-craft-seomatic)[craftcms/aws-s3 Amazon S3 integration for Craft CMS 631.5M26](/packages/craftcms-aws-s3)[verbb/navigation Create navigation menus for your site. 90683.7k17](/packages/verbb-navigation)[verbb/formie The most user-friendly forms plugin for Craft. 101372.9k40](/packages/verbb-formie)[solspace/craft-freeform The most flexible and user-friendly form building plugin! 52664.9k12](/packages/solspace-craft-freeform) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)