PHPackages                             stepanenko3/nova-media-field - 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 &amp; Media](/categories/media)
4. /
5. stepanenko3/nova-media-field

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

stepanenko3/nova-media-field
============================

A Laravel Nova field for laravel-medilibrary.

v3.0.1(2y ago)1717.5k↓33.3%6[5 PRs](https://github.com/stepanenko3/nova-media-field/pulls)MITVuePHP ^8.2CI passing

Since Apr 10Pushed 1y ago1 watchersCompare

[ Source](https://github.com/stepanenko3/nova-media-field)[ Packagist](https://packagist.org/packages/stepanenko3/nova-media-field)[ RSS](/packages/stepanenko3-nova-media-field/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (17)Used By (0)

Nova Media Field
================

[](#nova-media-field)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7fa90bb7a41b5313c383e02451224e1c6fd24f0b09f73e62b621a1620465870d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73746570616e656e6b6f332f6e6f76612d6d656469612d6669656c642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/stepanenko3/nova-media-field)[![Total Downloads](https://camo.githubusercontent.com/e1de09ed340d5193cfc58229935e40d373886bdf0bd5f48cda29d532c899af25/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73746570616e656e6b6f332f6e6f76612d6d656469612d6669656c642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/stepanenko3/nova-media-field)[![License](https://camo.githubusercontent.com/2e6ef5ece73e10071e6c082c93a27c48130ae285e49f873b60c97cf362531fa2/68747470733a2f2f706f7365722e707567782e6f72672f73746570616e656e6b6f332f6e6f76612d6d656469612d6669656c642f6c6963656e7365)](https://packagist.org/packages/stepanenko3/nova-media-field)

[![screenshot of field](screenshots/field.png)](screenshots/field.png)

Description
-----------

[](#description)

A Laravel Nova field for laravel-medilibrary.

Features
--------

[](#features)

- Multiple / Single image support
- Multiple images auto-detect based on collection
- Display validation errors
- Show on index multiple images
- Modal with media details
- Show all conversions
- Open / Download / Copy URL of media
- Regenerate image with conversions
- Custom properties support

Requirements
------------

[](#requirements)

- `php: >=8.0`
- `laravel/nova: ^4.0`
- `spatie/laravel-medilibrary`: ^11.4

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

[](#installation)

```
# Install the package
composer require stepanenko3/nova-media-field
```

Usage
-----

[](#usage)

```
use use Stepanenko3\NovaMediaField\Fields\Media;
...

Media::make(__('Image'), 'image'), // Single image. Auto detect from collection

Media::make(__('Images'), 'images'), // Multiple images. Auto detect from collection

// Validation rules

Media::make('Images', 'images')
    ->rules(['required', 'array', 'max:4'])
    ->singleMediaRules(['image', 'max:80']),

// Custom properties with validtion

Media::make('Images', 'images')
    ->customPropertiesFields([
        Boolean::make('Active', 'active')
            ->rules(['boolean']),

        Markdown::make('Description', 'description')
            ->rules(['max:1000']),
    ])

// Count images displayed on index

Media::make('Images', 'images')
    ->countOfImagesDisplayedOnIndex(2),

// Full example

Media::make('Images', 'images')
    ->customPropertiesFields([
        Boolean::make('Active', 'active')
            ->rules(['boolean']),

        Markdown::make('Description', 'description')
            ->rules(['max:1000']),
    ])
    ->countOfImagesDisplayedOnIndex(2)
    ->rules(['required', 'array', 'max:4'])
    ->singleMediaRules(['image', 'max:80']),
```

Usage with File Manager
-----------------------

[](#usage-with-file-manager)

### Install stepanenko3/nova-filemanager

[](#install-stepanenko3nova-filemanager)

```
compore require stepanenko3/nova-filemanager
```

### Register Service provider

[](#register-service-provider)

```
// app/Providers/NovaServiceProvider.php

public function tools(): array
{
    return [
        new Stepanenko3\NovaFileManager\FileManagerTool,
    ];
}
```

### Use Media field with File Manager

[](#use-media-field-with-file-manager)

```
Media::make(__('Image'), 'image')
    ->fileManager(),
```

Screenshots
-----------

[](#screenshots)

[![screenshot of field](screenshots/field-dark.png)](screenshots/field-dark.png)[![screenshot of field](screenshots/field-detail.png)](screenshots/field-detail.png)[![screenshot of field](screenshots/field-index.png)](screenshots/field-index.png)[![screenshot of field](screenshots/field-index2.png)](screenshots/field-index2.png)[![screenshot of field](screenshots/field-with-properties.png)](screenshots/field-with-properties.png)[![screenshot of field](screenshots/field-properties.png)](screenshots/field-properties.png)

Credits
-------

[](#credits)

- [Artem Stepanenko](https://github.com/stepanenko3)

Contributing
------------

[](#contributing)

Thank you for considering contributing to this package! Please create a pull request with your contributions with detailed explanation of the changes you are proposing.

License
-------

[](#license)

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

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 59% 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 ~80 days

Total

9

Last Release

782d ago

Major Versions

v1.0.9 → v2.0.02023-06-16

v2.0.0 → v3.0.02024-03-28

PHP version history (2 changes)v1.0.0PHP ^7.3|^8.0

v3.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/bef20f9543018de0b011aaf817248d926fdbcd2f71c6cfa81d82e9bb4822f018?d=identicon)[stepanenko3](/maintainers/stepanenko3)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (23 commits)")[![stepanenko3](https://avatars.githubusercontent.com/u/31134245?v=4)](https://github.com/stepanenko3 "stepanenko3 (16 commits)")

---

Tags

laravelmediafieldnova

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/stepanenko3-nova-media-field/health.svg)

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

###  Alternatives

[classic-o/nova-media-library

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

154172.0k](/packages/classic-o-nova-media-library)[silvanite/nova-field-cloudinary

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

2772.0k3](/packages/silvanite-nova-field-cloudinary)[mostafaznv/nova-ckeditor

CkEditor for Laravel Nova

57327.2k1](/packages/mostafaznv-nova-ckeditor)[tomatophp/filament-media-manager

Manage your media files using spatie media library with easy to use GUI for FilamentPHP

14543.9k3](/packages/tomatophp-filament-media-manager)[mostafaznv/nova-video

Video Field for Laravel Nova

22398.0k1](/packages/mostafaznv-nova-video)[synchro/laravel-medialibrary-audio

Audio file thumbnail generator for Spatie's Laravel Media Library

292.4k](/packages/synchro-laravel-medialibrary-audio)

PHPackages © 2026

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