PHPackages                             harvirsidhu/filament-header-actions - 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. harvirsidhu/filament-header-actions

ActiveLibrary

harvirsidhu/filament-header-actions
===================================

Compose Filament header actions into primary actions plus a More overflow menu.

v1.0.5(2mo ago)036MITPHPPHP ^8.2CI passing

Since Feb 20Pushed 2mo agoCompare

[ Source](https://github.com/harvirsidhu/filament-header-actions)[ Packagist](https://packagist.org/packages/harvirsidhu/filament-header-actions)[ Docs](https://github.com/harvirsidhu/filament-header-actions)[ GitHub Sponsors](https://github.com/harvirsidhu)[ RSS](/packages/harvirsidhu-filament-header-actions/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelog (5)Dependencies (12)Versions (7)Used By (0)

Filament Header Actions
=======================

[](#filament-header-actions)

[![Latest Version on Packagist](https://camo.githubusercontent.com/92bdf2f98f65f92daa0d740d6430447496fc03c9fed5fd7d7a77817771763a37/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68617276697273696468752f66696c616d656e742d6865616465722d616374696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/harvirsidhu/filament-header-actions)[![Total Downloads](https://camo.githubusercontent.com/97990bd4ba132dc85b57db040f0d5a8d2c5b4692a271412e4cfa4ad5746f7f10/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f68617276697273696468752f66696c616d656e742d6865616465722d616374696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/harvirsidhu/filament-header-actions)

`filament-header-actions` composes an ordered list of Filament actions into:

- primary actions (first `N`, default `1`),
- and a `More` overflow action group for remaining actions.

Behavior is deterministic:

- no overflow =&gt; no `More`,
- one overflow action =&gt; flattened directly,
- two or more overflow actions =&gt; grouped under `More`.
- actions that evaluate as hidden or invisible are ignored before composing.
- authorization filtering is opt-in via `filter_unauthorized` (default `false`).

Compatibility
-------------

[](#compatibility)

PackageSupported versionsFilament`^4.0` and `^5.0`PHP`^8.2`Installation
------------

[](#installation)

```
composer require harvirsidhu/filament-header-actions
```

Config is optional. The package works without publishing it.

If you want to customize defaults, publish config:

```
php artisan vendor:publish --tag="filament-header-actions-config"
```

```
return [
    'primary_count' => 1,
    'label' => 'More',
    'icon' => 'heroicon-m-ellipsis-horizontal',
    'color' => 'gray',
    'hidden_label' => false,
    'button' => true,
    'icon_position' => \Filament\Support\Enums\IconPosition::After, // right
    'filter_unauthorized' => false,
];
```

Usage
-----

[](#usage)

### Easy usage

[](#easy-usage)

```
use Filament\Actions\Action;
use Harvirsidhu\FilamentHeaderActions\Facades\FilamentHeaderActions;

public function getHeaderActions(): array
{
    $actions = [
        Action::make('edit'),
        Action::make('archive'),
        Action::make('delete'),
    ];

    return FilamentHeaderActions::make($actions)->toActions();
}
```

### Visibility filtering example

[](#visibility-filtering-example)

```
public function getHeaderActions(): array
{
    $actions = [
        Action::make('edit')->hidden(true),     // ignored
        Action::make('archive'),                // kept
        Action::make('delete')->visible(false), // ignored
        Action::make('publish')->authorize('update', $this->record), // kept by default
    ];

    // primary_count = 1:
    // - first available action stays primary
    // - remaining available actions go to More (or flatten if only one)
    return FilamentHeaderActions::make($actions)->toActions();
}
```

### Optional authorization pre-filtering

[](#optional-authorization-pre-filtering)

```
return FilamentHeaderActions::make($actions)
    ->filterUnauthorized() // opt-in (default is false)
    ->toActions();
```

### Full usage (all options)

[](#full-usage-all-options)

```
FilamentHeaderActions::make($actions)
    ->primaryCount(int $count = 1)
    ->label(string $label = 'More')
    ->icon(string|\BackedEnum|null $icon = null)
    ->color(string $color = 'gray')
    ->hiddenLabel(bool $state = true)
    ->button(bool $state = true)
    ->iconPosition(\Filament\Support\Enums\IconPosition $position = \Filament\Support\Enums\IconPosition::After)
    ->filterUnauthorized(bool $state = true)
    ->toActions();
```

Testing
-------

[](#testing)

```
composer test
```

Release checklist
-----------------

[](#release-checklist)

- Update changelog with user-facing changes.
- Run linting and static analysis.
- Run Pest locally.
- Ensure CI passes Filament 4 and 5 matrix jobs.

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [harvirsidhu](https://github.com/harvirsidhu)
- [All Contributors](https://github.com/harvirsidhu/filament-header-actions/contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance83

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity51

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

Total

7

Last Release

87d ago

### Community

Maintainers

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

---

Top Contributors

[![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (78 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (32 commits)")[![zepfietje](https://avatars.githubusercontent.com/u/44533235?v=4)](https://github.com/zepfietje "zepfietje (24 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (22 commits)")[![danharrin](https://avatars.githubusercontent.com/u/41773797?v=4)](https://github.com/danharrin "danharrin (7 commits)")[![ryangjchandler](https://avatars.githubusercontent.com/u/41837763?v=4)](https://github.com/ryangjchandler "ryangjchandler (7 commits)")[![bizexcel](https://avatars.githubusercontent.com/u/46524294?v=4)](https://github.com/bizexcel "bizexcel (6 commits)")[![saade](https://avatars.githubusercontent.com/u/14329460?v=4)](https://github.com/saade "saade (4 commits)")[![maartenpaauw](https://avatars.githubusercontent.com/u/4550875?v=4)](https://github.com/maartenpaauw "maartenpaauw (4 commits)")[![harvirsidhu](https://avatars.githubusercontent.com/u/7453102?v=4)](https://github.com/harvirsidhu "harvirsidhu (3 commits)")[![AlexisSerneels](https://avatars.githubusercontent.com/u/287688?v=4)](https://github.com/AlexisSerneels "AlexisSerneels (2 commits)")[![Z3d0X](https://avatars.githubusercontent.com/u/75579178?v=4)](https://github.com/Z3d0X "Z3d0X (1 commits)")[![ArielMejiaDev](https://avatars.githubusercontent.com/u/31971074?v=4)](https://github.com/ArielMejiaDev "ArielMejiaDev (1 commits)")[![a21ns1g4ts](https://avatars.githubusercontent.com/u/11599205?v=4)](https://github.com/a21ns1g4ts "a21ns1g4ts (1 commits)")[![atmonshi](https://avatars.githubusercontent.com/u/1952412?v=4)](https://github.com/atmonshi "atmonshi (1 commits)")[![cheesegrits](https://avatars.githubusercontent.com/u/934456?v=4)](https://github.com/cheesegrits "cheesegrits (1 commits)")[![darmshot](https://avatars.githubusercontent.com/u/29179227?v=4)](https://github.com/darmshot "darmshot (1 commits)")[![Abdulmajeed-Jamaan](https://avatars.githubusercontent.com/u/41128358?v=4)](https://github.com/Abdulmajeed-Jamaan "Abdulmajeed-Jamaan (1 commits)")[![gpibarra](https://avatars.githubusercontent.com/u/21188012?v=4)](https://github.com/gpibarra "gpibarra (1 commits)")[![lucasgiovanny](https://avatars.githubusercontent.com/u/4853801?v=4)](https://github.com/lucasgiovanny "lucasgiovanny (1 commits)")

---

Tags

laravelfilamentfilament-pluginfilamentphpharvirsidhufilament-header-actions

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/harvirsidhu-filament-header-actions/health.svg)

```
[![Health](https://phpackages.com/badges/harvirsidhu-filament-header-actions/health.svg)](https://phpackages.com/packages/harvirsidhu-filament-header-actions)
```

###  Alternatives

[croustibat/filament-jobs-monitor

Background Jobs monitoring like Horizon for all drivers for FilamentPHP

254255.2k6](/packages/croustibat-filament-jobs-monitor)[relaticle/custom-fields

User Defined Custom Fields for Laravel Filament

15828.6k](/packages/relaticle-custom-fields)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[guava/filament-modal-relation-managers

Allows you to embed relation managers inside filament modals.

7565.0k4](/packages/guava-filament-modal-relation-managers)[defstudio/filament-searchable-input

A searchable autocomplete input for Filament forms

3212.4k](/packages/defstudio-filament-searchable-input)[agencetwogether/hookshelper

Simple plugin to toggle display hooks available in current page.

2312.7k](/packages/agencetwogether-hookshelper)

PHPackages © 2026

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