PHPackages                             umnikone/nova-field-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. [Image & Media](/categories/media)
4. /
5. umnikone/nova-field-cloudinary

ActiveLibrary[Image & Media](/categories/media)

umnikone/nova-field-cloudinary
==============================

A Laravel Nova Image Field with Flysystem Adapter for storing and retrieving media from Cloudinary

v1.0.3(2y ago)027MITPHPPHP >=7.0.0

Since Jun 12Pushed 2y agoCompare

[ Source](https://github.com/UmnikOne/nova-field-cloudinary)[ Packagist](https://packagist.org/packages/umnikone/nova-field-cloudinary)[ RSS](/packages/umnikone-nova-field-cloudinary/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (4)Versions (4)Used By (0)

Cloudinary Fields and Adapter for Laravel Nova
==============================================

[](#cloudinary-fields-and-adapter-for-laravel-nova)

A collection of Laravel Nova fields with a Flysystem Adapter for storing and retrieving media from Cloudinary.

This package will enable you to use the [Cloudinary](https://cloudinary.com) service to handle your Nova file uploads.

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

[](#installation)

Install the package using composer

```
composer require silvanite/nova-field-cloudinary
```

Add the cloudinary disk to the filesystem config and set the environment variables for your Cloudinary account.

```
// config/filesystem.php
return [
    ...
    'disks' => [
        ...
        'cloudinary' => [
            'driver' => 'cloudinary',
            'api_key' => env('CLOUDINARY_API_KEY'),
            'api_secret' => env('CLOUDINARY_API_SECRET'),
            'cloud_name' => env('CLOUDINARY_CLOUD_NAME'),
        ]
    ]
];
```

Using the CloudinaryImage Field
-------------------------------

[](#using-the-cloudinaryimage-field)

Simply use the `CloudinaryImage` field in your Resource's fields instead of the standard Nova `Image` field. This component extends the default Image field so you can use it with all the same options as the standard field.

```
use Silvanite\NovaFieldCloudinary\Fields\CloudinaryImage;

public function fields(Request $request)
{
    return [
        ...
        CloudinaryImage::make('Profile Photo'),
    ]
}
```

This will essentially do the same as `Image::make()->disk('cloudinary')` but it will also serve resized and optimised preview and thumbnail images within the Nova UI itself. However if you don't want this you can just use the standard `Image` field.

To use images in your application you can either use the `cloudinary_image` helper or read the image using the `Storage` facade.

```
// Using the helper (with transformation)

return cloudinary_image($this->profile_photo, [
    "width" => 200,
    "height" => 200,
    "crop" => "fill",
    "gravity" => "auto",
])

// Using the Storage Facade (without transformation)

return Storage::disk('cloudinary')->url($this->profile_photo);

// Using the Storage Facade (with transformation)

return Storage::disk('cloudinary')->url([
    'public_id' => $this->profile_photo,
    'options' => [
        "width" => 200,
        "height" => 200,
        "crop" => "fill",
        "gravity" => "auto",
    ],
])
```

### Max file size

[](#max-file-size)

Cloudinary imposes maximum file sizes on images depending on your account plan. At the time of writing the free plan allows images up to 10mb.

If a successfully uploaded image is transformed by cloudinary and upscaled past this file size, the download of that image will fail with a 400 error on the front end.

This situation is especially likely to occur if working with animated GIF images which are typically quite large files at smaller resolutions, liable to upscaling by image processors.

Using the CloudinaryAudio Field
-------------------------------

[](#using-the-cloudinaryaudio-field)

Simply use the `CloudinaryAudio` field in your Resource's fields. This component extends `davidpiesse/nova-audio` which in turn extends the default Nova File field so you can use it with all the same options as the standard field.

```
use Silvanite\NovaFieldCloudinary\Fields\CloudinaryAudio;

public function fields(Request $request)
{
    return [
        ...
        CloudinaryAudio::make('Audio Source'),
    ]
}
```

This field sets the disk in use to `Cloudinary` and ensures the media is stored in the database field with the correct file extension. Further to this, the field sets the preview URL to use the appropriate path within Cloudinary so that the audio can be played back in the CMS.

To use the audio files in your application you can either use the `cloudinary_audio()` helper or read the audio file using the `Storage` facade. Note, Cloudinary stores both images and video together so if using the `Storage` facade, the `resource_type` should be set to `video` in the options array.

```
// Using the audio helper

return cloudinary_audio($this->audio_source);

// Using the Storage Facade

return Storage::disk('cloudinary')->url([
    'public_id' => $this->audio_source,
    'options' => [
        "resource_type" => "video",
    ],
])
```

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70% 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 ~882 days

Total

3

Last Release

814d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/22861012?v=4)[UmnikOne](/maintainers/UmnikOne)[@UmnikOne](https://github.com/UmnikOne)

---

Top Contributors

[![m2de](https://avatars.githubusercontent.com/u/17720020?v=4)](https://github.com/m2de "m2de (21 commits)")[![crumb1e](https://avatars.githubusercontent.com/u/18497168?v=4)](https://github.com/crumb1e "crumb1e (4 commits)")[![UmnikOne](https://avatars.githubusercontent.com/u/22861012?v=4)](https://github.com/UmnikOne "UmnikOne (3 commits)")[![eithed](https://avatars.githubusercontent.com/u/795678?v=4)](https://github.com/eithed "eithed (2 commits)")

---

Tags

laravelimagesmediacloudinaryfieldnova

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/umnikone-nova-field-cloudinary/health.svg)

```
[![Health](https://phpackages.com/badges/umnikone-nova-field-cloudinary/health.svg)](https://phpackages.com/packages/umnikone-nova-field-cloudinary)
```

###  Alternatives

[silvanite/nova-field-cloudinary

A Laravel Nova Image Field with Flysystem Adapter for storing and retrieving media from Cloudinary

2772.3k3](/packages/silvanite-nova-field-cloudinary)[classic-o/nova-media-library

Tool and field that will let you managing files and add them to the posts

154180.4k](/packages/classic-o-nova-media-library)[stepanenko3/nova-media-field

A Laravel Nova field for laravel-medilibrary.

1817.8k](/packages/stepanenko3-nova-media-field)[mostafaznv/nova-video

Video Field for Laravel Nova

22437.2k2](/packages/mostafaznv-nova-video)[okipa/laravel-medialibrary-ext

Extra features for spatie/laravel-medialibrary package.

1011.2k](/packages/okipa-laravel-medialibrary-ext)

PHPackages © 2026

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