PHPackages                             awcodes/filament-sticky-header - 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. [Framework](/categories/framework)
4. /
5. awcodes/filament-sticky-header

ActiveLibrary[Framework](/categories/framework)

awcodes/filament-sticky-header
==============================

A Filament Panel plugin to make page headers sticky when scrolling.

v4.1.0(1mo ago)82138.9k↓16.2%14[2 PRs](https://github.com/awcodes/filament-sticky-header/pulls)1MITPHPPHP ^8.2CI passing

Since Jun 16Pushed 1w ago2 watchersCompare

[ Source](https://github.com/awcodes/filament-sticky-header)[ Packagist](https://packagist.org/packages/awcodes/filament-sticky-header)[ GitHub Sponsors](https://github.com/awcodes)[ RSS](/packages/awcodes-filament-sticky-header/feed)WikiDiscussions 4.x Synced 2d ago

READMEChangelog (10)Dependencies (18)Versions (42)Used By (1)

Filament Sticky Header
======================

[](#filament-sticky-header)

A Filament Panel plugin to make page headers sticky when scrolling.

[![Latest Version](https://camo.githubusercontent.com/e7af980d6df06a3aa40902428bc8a6cec9484bb5128a6a1fc072449975f36b93/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6177636f6465732f66696c616d656e742d737469636b792d6865616465722e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d52656c65617365)](https://github.com/awcodes/filament-sticky-header/releases)[![MIT Licensed](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/3d33f922c9a1d716bcc8e47f8f57baa9aaacaaa3bfb9fabb8428778ec25ae3e1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6177636f6465732f66696c616d656e742d737469636b792d6865616465722e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/awcodes/filament-sticky-header)[![GitHub Repo stars](https://camo.githubusercontent.com/afca1b5af1898dbbc87dd77daf30c1e6f04dce7c8cb9d022bffe7d9f32befedc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6177636f6465732f66696c616d656e742d737469636b792d6865616465723f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d5374617273)](https://github.com/awcodes/filament-sticky-header/stargazers)

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

[](#compatibility)

Package VersionFilament Version1.x2.x2.x3.x3.x4.x4.x5.xInstallation
------------

[](#installation)

Install packages via composer

```
composer require awcodes/filament-sticky-header
```

Important

If you have not set up a custom theme and are using Filament Panels follow the instructions in the [Filament Docs](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) first.

After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone packages.

```
@import '../../../../vendor/awcodes/filament-sticky-header/resources/css/plugin.css';
```

Usage
-----

[](#usage)

Just add the plugin to your panel provider, and you're good to go.

```
use Awcodes\StickyHeader\StickyHeaderPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            StickyHeaderPlugin::make(),
        ])
    ])
}
```

### Floating Theme

[](#floating-theme)

To use the 'Floating Theme' use the `floating()` method when instantiating the plugin.

When using the floating theme you can also use the `colored()` method to add your primary background color to the header.

```
use Awcodes\StickyHeader\StickyHeaderPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            StickyHeaderPlugin::make()
                ->floating()
                ->colored()
        ])
    ]);
}
```

Both the `floating()` and `colored()` methods can receive closure that will be evaluated to determine if the theme should be applied. This allows you to apply the theme conditionally, for instance, based off of user preferences.

```
use Awcodes\StickyHeader\StickyHeaderPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            StickyHeaderPlugin::make()
                ->floating(fn():bool => auth()->user()->use_floating_header)
                ->colored(fn():bool => auth()->user()->use_floating_header)
        ])
    ]);
}
```

### Disabling on List Pages

[](#disabling-on-list-pages)

To disable the sticky header on list pages, you can use the `stickOnListPages()` method.

```
use Awcodes\StickyHeader\StickyHeaderPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            StickyHeaderPlugin::make()
                ->stickOnListPages(false)
        ])
    ]);
}
```

### Disabling on Custom Pages

[](#disabling-on-custom-pages)

To disable the sticky header on specific custom pages, pass an array of page class names (or a Closure returning one) to the `disabledOn()` method.

```
use Awcodes\StickyHeader\StickyHeaderPlugin;
use App\Filament\Pages\MyCustomPage;
use App\Filament\Pages\AnotherPage;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            StickyHeaderPlugin::make()
                ->disabledOn([
                    MyCustomPage::class,
                    AnotherPage::class,
                ])
        ])
    ]);
}
```

A Closure is also accepted, which allows the list to be determined at runtime.

```
StickyHeaderPlugin::make()
    ->disabledOn(fn () => [MyCustomPage::class])
```

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](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Adam Weston](https://github.com/awcodes)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

63

—

FairBetter than 99% of packages

Maintenance95

Actively maintained with recent releases

Popularity48

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 68.9% 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 ~37 days

Total

40

Last Release

4d ago

Major Versions

v1.3.3 → v2.0.0-alpha12023-05-04

v2.0.8 → v3.0.0-beta.12025-06-15

2.x-dev → v3.0.02025-08-12

v3.0.0 → v4.0.02026-01-19

v3.1.0 → v4.1.02026-05-21

PHP version history (3 changes)v1.0.0PHP ^8.0.2

v2.0.0-alpha2PHP ^8.1

v3.0.0-beta.1PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3596800?v=4)[Adam Weston](/maintainers/awcodes)[@awcodes](https://github.com/awcodes)

---

Top Contributors

[![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (71 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (20 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (9 commits)")[![hofey](https://avatars.githubusercontent.com/u/7634241?v=4)](https://github.com/hofey "hofey (1 commits)")[![martin-ro](https://avatars.githubusercontent.com/u/10107779?v=4)](https://github.com/martin-ro "martin-ro (1 commits)")[![rhiannonjourney](https://avatars.githubusercontent.com/u/148484535?v=4)](https://github.com/rhiannonjourney "rhiannonjourney (1 commits)")

---

Tags

filamentfilament-pluginframeworklaravelfilament

###  Code Quality

TestsPest

Static AnalysisRector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/awcodes-filament-sticky-header/health.svg)

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

###  Alternatives

[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17760.2k3](/packages/stephenjude-filament-jetstream)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[croustibat/filament-jobs-monitor

Background Jobs monitoring like Horizon for all drivers for FilamentPHP

274325.8k8](/packages/croustibat-filament-jobs-monitor)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6649.5k1](/packages/marcelweidum-filament-passkeys)[stephenjude/filament-debugger

About

104162.2k2](/packages/stephenjude-filament-debugger)

PHPackages © 2026

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