PHPackages                             kazeeem/cloudinary-laravel - 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. [File &amp; Storage](/categories/file-storage)
4. /
5. kazeeem/cloudinary-laravel

ActiveLibrary[File &amp; Storage](/categories/file-storage)

kazeeem/cloudinary-laravel
==========================

A Laravel Cloudinary Package Forked From CloudinaryLabs/cloudinary-laravel with support for Laravel 13

v2.0.1(3mo ago)0542↓38.9%MITPHPPHP ^8.2|^8.3CI failing

Since Apr 10Pushed 3mo agoCompare

[ Source](https://github.com/Kazeeem/cloudinary-laravel)[ Packagist](https://packagist.org/packages/kazeeem/cloudinary-laravel)[ Docs](https://github.com/kazeeem/cloudinary-laravel)[ RSS](/packages/kazeeem-cloudinary-laravel/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (8)Versions (5)Used By (0)

   ![Cloudinary](https://user-images.githubusercontent.com/62209650/196528761-a815025a-271a-4d8e-ac7e-cea833728bf9.png)    ![Laravel](https://user-images.githubusercontent.com/1045274/200928533-47539867-07ff-406e-aa8b-25c594652dc8.png)
[![Total Downloads](https://camo.githubusercontent.com/83fd392cb6c332c4e1f3ef0987bf52f50973a4752fca33f5013aef420bf6d5c7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c6f7564696e6172792d6c6162732f636c6f7564696e6172792d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cloudinary-labs/cloudinary-laravel)[![Latest Stable Version](https://camo.githubusercontent.com/bb76fffcac1e23c483f2935b6f19fe42242e7575bfc9ca09864d5e7d8fefca9c/68747470733a2f2f706f7365722e707567782e6f72672f636c6f7564696e6172792d6c6162732f636c6f7564696e6172792d6c61726176656c2f762f737461626c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cloudinary-labs/cloudinary-laravel)[![GitHub](https://camo.githubusercontent.com/499a6fcc0326ed9c9f204e3ee8220f22adc02f87ff2b51d86103210afd89ea6e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636c6f7564696e6172792d646576732f636c6f7564696e6172792d6c61726176656c3f6c6162656c3d4c6963656e7365267374796c653d666c61742d737175617265)](https://github.com/cloudinary-devs/cloudinary-laravel/blob/main/LICENSE)

> A Laravel Package for uploading, optimizing, transforming and delivering media files with Cloudinary. Furthermore, it provides a fluent and expressive API to easily attach your media files to Eloquent models.

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Usage](#usage)
    - [File Storage Driver](#file-storage-driver)
    - [Blade Components](#blade-components)
- [Disclaimer](#disclaimer)
- [Contributions](#contributions)
- [License](#license)

Installation
------------

[](#installation)

Requires PHP 8.2+ and Laravel 11+.

```
composer require kazeeem/cloudinary-laravel
```

After you have installed the SDK, you can invoke the install command to set everything up:

```
php artisan cloudinary:install
```

Add your Cloudinary credentials to your `.env` file:

```
CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME
CLOUDINARY_UPLOAD_PRESET=your_upload_preset
CLOUDINARY_NOTIFICATION_URL=

```

Note

You can get your `CLOUDINARY_URL` from your [Cloudinary console](https://cloudinary.com/console). It typically looks like this: `cloudinary://API_KEY:API_SECRET@CLOUD_NAME`. Make sure to replace `API_KEY`, `API_SECRET`, and `CLOUD_NAME` with your actual Cloudinary credentials.

Usage
-----

[](#usage)

### File Storage Driver

[](#file-storage-driver)

This SDK implements the [File Storage](https://laravel.com/docs/12.x/filesystem#main-content) Driver interface allowing you to use it as just another storage destination like s3, azure or local disk.

Add a new `cloudinary` key to your `config/filesystems.php` disk key like so:

```
  ...,
  'cloudinary' => [
      'driver' => 'cloudinary',
      'key' => env('CLOUDINARY_KEY'),
      'secret' => env('CLOUDINARY_SECRET'),
      'cloud' => env('CLOUDINARY_CLOUD_NAME'),
      'url' => env('CLOUDINARY_URL'),
      'secure' => (bool) env('CLOUDINARY_SECURE', true),
      'prefix' => env('CLOUDINARY_PREFIX'),
  ],
...,
```

### Blade Components

[](#blade-components)

This package provides a few Blade components for easy integration of Cloudinary media in your Laravel views.

#### Upload Widget

[](#upload-widget)

You can use the `` Blade component that ships with this like so:

```

    Upload Files

```

#### Image Component

[](#image-component)

Basic usage:

```

```

With additional properties:

```

```

##### Properties available:

[](#properties-available)

PropertyRequired`public-id`Yes`width`No`height`No`alt`No`class`No`crop`No`gravity`No`effect`No`rotate`No`colorize`No`trim`No`blur`No`gray-scale`No`black-white`No`sepia`No`redeye`No`negate`No`oil-paint`No`vignette`No`simulate-colorblind`No`pixelate`No`unsharp-mask`No`saturation`No`contrast`No`brightness`No`gamma`No`improve-mode`No`shadow`No`border`No`round-corners`No`bg-color`No`art`No`cartoonify`No#### Video Component

[](#video-component)

Basic usage:

```

```

With additional properties:

```

```

##### Properties available:

[](#properties-available-1)

PropertyRequired`public-id`Yes`width`No`height`NoDisclaimer
----------

[](#disclaimer)

> *This software/code provided under Cloudinary Labs is an unsupported pre-production prototype undergoing further development and provided on an “AS IS” basis without warranty of any kind, express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. Furthermore, Cloudinary is not under any obligation to provide a commercial version of the software.
>
>  Your use of the Software/code is at your sole risk and Cloudinary will not be liable for any direct, indirect, incidental, special, exemplary, consequential or similar damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of the Software, even if advised of the possibility of such damage.
>
>  You should refrain from uploading any confidential or personally identifiable information to the Software. All rights to and in the Software are and will remain at all times, owned by, or licensed to Cloudinary.*

Contributions
-------------

[](#contributions)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE.md).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance81

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~2 days

Total

3

Last Release

101d ago

Major Versions

v1.1.0 → v2.0.12026-04-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/0f469980a9c6588ca4d33df6f702fb52473f71a8cb368e7a106fb458cafb82da?d=identicon)[Kazeeem](/maintainers/Kazeeem)

---

Top Contributors

[![unicodeveloper](https://avatars.githubusercontent.com/u/2946769?v=4)](https://github.com/unicodeveloper "unicodeveloper (77 commits)")[![joshmanders](https://avatars.githubusercontent.com/u/352113?v=4)](https://github.com/joshmanders "joshmanders (68 commits)")[![SlimGee](https://avatars.githubusercontent.com/u/42301835?v=4)](https://github.com/SlimGee "SlimGee (7 commits)")[![Delaney](https://avatars.githubusercontent.com/u/25111543?v=4)](https://github.com/Delaney "Delaney (5 commits)")[![Kazeeem](https://avatars.githubusercontent.com/u/35298707?v=4)](https://github.com/Kazeeem "Kazeeem (5 commits)")[![colbyfayock](https://avatars.githubusercontent.com/u/1045274?v=4)](https://github.com/colbyfayock "colbyfayock (4 commits)")[![asisayag2](https://avatars.githubusercontent.com/u/42962333?v=4)](https://github.com/asisayag2 "asisayag2 (3 commits)")[![parth391](https://avatars.githubusercontent.com/u/4966579?v=4)](https://github.com/parth391 "parth391 (2 commits)")[![saineshmamgain](https://avatars.githubusercontent.com/u/16660523?v=4)](https://github.com/saineshmamgain "saineshmamgain (2 commits)")[![JeremyDunn](https://avatars.githubusercontent.com/u/161614?v=4)](https://github.com/JeremyDunn "JeremyDunn (2 commits)")[![igmansvi](https://avatars.githubusercontent.com/u/122787819?v=4)](https://github.com/igmansvi "igmansvi (1 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)")[![Mdhesari](https://avatars.githubusercontent.com/u/28428724?v=4)](https://github.com/Mdhesari "Mdhesari (1 commits)")[![miteyema](https://avatars.githubusercontent.com/u/2599590?v=4)](https://github.com/miteyema "miteyema (1 commits)")[![newtonjob](https://avatars.githubusercontent.com/u/39219424?v=4)](https://github.com/newtonjob "newtonjob (1 commits)")[![nova4005](https://avatars.githubusercontent.com/u/3578444?v=4)](https://github.com/nova4005 "nova4005 (1 commits)")[![oscar-rey-mosquera](https://avatars.githubusercontent.com/u/65368810?v=4)](https://github.com/oscar-rey-mosquera "oscar-rey-mosquera (1 commits)")[![peteeveleigh](https://avatars.githubusercontent.com/u/827065?v=4)](https://github.com/peteeveleigh "peteeveleigh (1 commits)")[![rnambaale](https://avatars.githubusercontent.com/u/7702522?v=4)](https://github.com/rnambaale "rnambaale (1 commits)")[![cybersai](https://avatars.githubusercontent.com/u/26746368?v=4)](https://github.com/cybersai "cybersai (1 commits)")

---

Tags

laravelfile uploadscloudinaryMedia managementcloudinary-laravelFile Transformations

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/kazeeem-cloudinary-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/kazeeem-cloudinary-laravel/health.svg)](https://phpackages.com/packages/kazeeem-cloudinary-laravel)
```

###  Alternatives

[cloudinary-labs/cloudinary-laravel

A Laravel Cloudinary Package

3321.4M5](/packages/cloudinary-labs-cloudinary-laravel)[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.5M86](/packages/unisharp-laravel-filemanager)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[yoelpc4/laravel-cloudinary

Laravel Cloudinary filesystem cloud driver.

3345.6k](/packages/yoelpc4-laravel-cloudinary)[codebar-ag/laravel-flysystem-cloudinary

Cloudinary Flysystem 3 integration with Laravel

1229.3k3](/packages/codebar-ag-laravel-flysystem-cloudinary)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
