PHPackages marshmallow/nova-fields-help - 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. [Utility & Helpers](/categories/utility) 4. / 5. marshmallow/nova-fields-help ActiveLibrary[Utility & Helpers](/categories/utility) marshmallow/nova-fields-help ============================ A Laravel Nova help field. 3.1.0(3mo ago)416.4k↓55.5%1[1 PRs](https://github.com/marshmallow-packages/nova-fields-help/pulls)2MITPHPPHP ^8.1CI passing Since Sep 9Pushed 2w ago1 watchersCompare [ Source](https://github.com/marshmallow-packages/nova-fields-help)[ Packagist](https://packagist.org/packages/marshmallow/nova-fields-help)[ RSS](/packages/marshmallow-nova-fields-help/feed)WikiDiscussions main Synced 2d ago READMEChangelog (7)Dependencies (6)Versions (18)Used By (2) [![alt text](https://camo.githubusercontent.com/f5450f299f5713ce2f04dd5a1ba7ce9960ed4568b3574e4c4ee3cddc75477253/68747470733a2f2f6d617273686d616c6c6f772e6465762f63646e2f6d656469612f6c6f676f2d7265642d3233377834362e706e67 "marshmallow.")](https://camo.githubusercontent.com/f5450f299f5713ce2f04dd5a1ba7ce9960ed4568b3574e4c4ee3cddc75477253/68747470733a2f2f6d617273686d616c6c6f772e6465762f63646e2f6d656469612f6c6f676f2d7265642d3233377834362e706e67) Laravel Nova Help Field ======================= [](#laravel-nova-help-field) [![Latest Version on Packagist](https://camo.githubusercontent.com/3b004ba5ed2db3b0ca2b3d3ec47c46e7e81edfd0b9f5c983b19aba0fb520601a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d617273686d616c6c6f772f6e6f76612d6669656c64732d68656c702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marshmallow/nova-fields-help)[![Total Downloads](https://camo.githubusercontent.com/33656dc19c748e7706197be41be4fa5f504b7b946f7c8e600fa7ba80acda5371/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d617273686d616c6c6f772f6e6f76612d6669656c64732d68656c702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marshmallow/nova-fields-help) A custom Laravel Nova field which allows you to show custom help messages within form, detail and index screens. [![Base example](./docs/nova-help.jpg)](./docs/nova-help.jpg) Installation ------------ [](#installation) Install the package via Composer in your Nova project: ``` composer require marshmallow/nova-fields-help ``` The field is registered automatically through Laravel package auto-discovery, so there is nothing else to configure. Usage ----- [](#usage) Add the field to a resource's `fields()` method: ``` use Marshmallow\Nova\Fields\Help\Help; public function fields(Request $request) { return [ Help::make('Help title', 'Help message!'), ]; } ``` [![Base example](./docs/base.png)](./docs/base.png) Options ------- [](#options) **Nova Help Field** has many options as follow: ### Default templates [](#default-templates) ``` Help::make('title', 'message'); // Default help message Help::success('title', 'message'); Help::info('title', 'message'); Help::warning('title', 'message'); Help::danger('title', 'message'); // There's also a special template for headings Help::header('title', 'subtitle'); // If you prefer you can call the non static type method Help::make('title', 'message')->type('warning'); ``` #### Help templates: [](#help-templates) [![Base example](./docs/templates.png)](./docs/templates.png) #### Headings template: [](#headings-template) [![Base example](./docs/headings.png)](./docs/headings.png) ### Custom types [](#custom-types) You can extend or replace the built-in types and their CSS classes: ``` // Merge your own types with the built-in ones Help::make('title', 'message') ->addTypes(['brand' => 'bg-brand-light text-brand-dark']) ->type('brand'); // Or replace the full set of types Help::make('title', 'message') ->types(['brand' => 'bg-brand-light text-brand-dark']) ->type('brand'); ``` ### Both title and message are optional [](#both-title-and-message-are-optional) ``` Help::make('Only title'); Help::make()->message('Only message'); ``` ### Messages can also be callable [](#messages-can-also-be-callable) ``` Help::make()->message(function () { return "{$this->name} is awesome!"; }); ``` ### Icons [](#icons) You can pick one of the default SVG icons () provided by [Steve Schoger](https://twitter.com/steveschoger). ``` Help::make('Title')->icon('help'); // the default one Help::make('Title')->icon('info'); Help::make('Title')->icon('warning'); Help::make('Title')->icon('danger'); // Load a custom one Help::make('Love you') ->message('Yes, I love you!') ->icon(''); // or show no icon at all Help::make('Sad')->withoutIcon(); ``` [![Base example](./docs/love.png)](./docs/love.png) ### Render html messages [](#render-html-messages) ``` Help::make('Title', 'Message with link')->displayAsHtml(); ``` From v0.2 the `displayAsHtml()` method applies also to the field name (unless shown as column header on index). ### Full width on details screen [](#full-width-on-details-screen) ``` // Remove annoing padding in detail screen, also the default behaviour for the heading template Help::make('Negative margin')->showFullWidthOnDetail(); ``` [![Base example](./docs/details-padding.png)](./docs/details-padding.png) ### With side label [](#with-side-label) ``` // Show a side label instead of the title on the top Help::make('Look I\'m on the side') ->message('I\'m not...') ->withSideLabel(); ``` [![Base example](./docs/label.png)](./docs/label.png) ### Collapsible help fields [](#collapsible-help-fields) Help fields can be made collapsible using the fluent method `collapsible()`. Collapsible help fields are collapsed by default and toggle their state clicking on their title. Also, keep in mind that collapsible fields must define both a title and message and cannot be used with side labels. ``` // Collapsible field Help::info('Click here to toggle', 'Lorem ipsum dolor sit amet...') ->collapsible(); ``` [![Base example](./docs/collapsible.png)](./docs/collapsible.png) ### Show help messages on index [](#show-help-messages-on-index) ``` /** * By default help messages aren't shown on index, * when enabled they are shown as an hoverable * icon showing a plain (no html) tooltip. */ Help::make('Column title') ->message('Message with link') // The link code will be stripped out on index ->alsoOnIndex(); // Field icons can be shown conditionally on index Help::make()->message(function () { return $this->name ? "{$this->name} is awesome!" : null; })->onlyOnIndex(); ``` [![Base example](./docs/tooltip.png)](./docs/tooltip.png) Changelog --------- [](#changelog) Please see [changelog.md](changelog.md) for more information on what has changed recently. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Stef van Esch](https://github.com/marshmallow-packages) - [Alessandro Benoit](mailto:alessandro@comodolab.it) - [All Contributors](https://github.com/marshmallow-packages/nova-fields-help/contributors) License ------- [](#license) The MIT License (MIT). Please see the [License File](LICENSE.md) for more information. ### Health Score 55 — FairBetter than 97% of packages Maintenance89 Actively maintained with recent releases Popularity30 Limited adoption so far Community16 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 53.1% 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 ~224 days Recently: every ~112 days Total 10 Last Release 108d ago Major Versions v1.0.1 → v2.0.02022-05-06 v2.5.0 → 3.0.02025-11-18 PHP version history (5 changes)v1.0.0PHP >=7.2.5 v1.0.1PHP ^7.2|^8.0|^8.1 v2.0.0PHP ^8.0|^8.1 v2.1.0PHP ^8.0 3.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/be33d2624e24c516e73892b0929447cc762f3622c024ab8d0d2a59042e5d2c7f?d=identicon)[marshmallow](/maintainers/marshmallow) --- Top Contributors [![stefvanesch](https://avatars.githubusercontent.com/u/46725619?v=4)](https://github.com/stefvanesch "stefvanesch (78 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (51 commits)")[![LTKort](https://avatars.githubusercontent.com/u/2412670?v=4)](https://github.com/LTKort "LTKort (18 commits)") --- Tags laravelhelpnovamarshmallow ### Embed Badge ![Health badge](/badges/marshmallow-nova-fields-help/health.svg) ``` [![Health](https://phpackages.com/badges/marshmallow-nova-fields-help/health.svg)](https://phpackages.com/packages/marshmallow-nova-fields-help) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed Laravel Page Speed 2.5k1.7M10](/packages/renatomarinho-laravel-page-speed)[vinkius-labs/laravel-page-speed Laravel Page Speed 2.5k12.5k1](/packages/vinkius-labs-laravel-page-speed)[emargareten/inertia-modal Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps. 90142.9k](/packages/emargareten-inertia-modal)[wearepixel/laravel-cart A cart implementation for Laravel 1374.8k](/packages/wearepixel-laravel-cart)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.4k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)