PHPackages cmsmaxinc/filament-error-pages - 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. cmsmaxinc/filament-error-pages ActiveLibrary[Utility & Helpers](/categories/utility) cmsmaxinc/filament-error-pages ============================== Users don’t see blank 404 or 503 error pages. Instead, it shows helpful messages or guides them when something goes wrong. v2.0.3(3mo ago)2340.5k—9.7%6[2 issues](https://github.com/cmsmaxinc/filament-error-pages/issues)MITPHPPHP ^8.2CI passing Since Jan 31Pushed 3mo ago2 watchersCompare [ Source](https://github.com/cmsmaxinc/filament-error-pages)[ Packagist](https://packagist.org/packages/cmsmaxinc/filament-error-pages)[ Docs](https://github.com/cmsmaxinc/filament-error-pages)[ RSS](/packages/cmsmaxinc-filament-error-pages/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (8)Versions (14)Used By (0) Filament Error Pages ==================== [](#filament-error-pages) [![Latest Version on Packagist](https://camo.githubusercontent.com/76c9c453b2f090e62b3359993d61166fe20c6d6ed2019534c163e1576d066b6b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636d736d6178696e632f66696c616d656e742d6572726f722d70616765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cmsmaxinc/filament-error-pages)[![Total Downloads](https://camo.githubusercontent.com/c2d1396702e85fe288414371b6187cfe0ad64b97ea9be49dce048ef5c67cbca0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636d736d6178696e632f66696c616d656e742d6572726f722d70616765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cmsmaxinc/filament-error-pages)[![License](https://camo.githubusercontent.com/94bb8d68a871693fb4183a00c3e17771452541e2657d664386f28682c675e63b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f636d736d6178696e632f66696c616d656e742d6572726f722d70616765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cmsmaxinc/filament-error-pages) This plugin provides a more user-friendly error page for Filament panels when an error occurs. Outside the Filament panel, the default Laravel error page will be displayed. [![thumbnail](art/thumbnail.jpg)](art/thumbnail.jpg) Installation ------------ [](#installation) You can install the package via composer: ``` composer require cmsmaxinc/filament-error-pages ``` ### Custom Theme [](#custom-theme) You will need to [create a custom theme](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) for the styles to be applied correctly. Make sure you add the following to your `theme.css` file you created for the theme. ``` @source '../../../../vendor/cmsmaxinc/filament-error-pages/resources/**/*.blade.php'; ``` Translations ------------ [](#translations) If you want to customize the translations, you can publish the translations file. ``` php artisan vendor:publish --tag="filament-error-pages-translations" ``` How does it work? ----------------- [](#how-does-it-work) When an error occurs, the plugin will check if the request is coming from a Filament panel. If it is, the custom error page will be displayed. If it is not, the default Laravel error page will be displayed. #### Are pages outside the panel covered? [](#are-pages-outside-the-panel-covered) The error pages are part of the Filament panel, and the plugin is designed to work within the panel. The plugin will not cover pages outside the panel. For example if your panel base URL is `/admin`, the plugin will cover `/admin/*` but not anything outside of `/admin`. What pages are covered? ----------------------- [](#what-pages-are-covered) The plugin will cover the following error pages: - 404 (Page not found) - 403 (Forbidden) Usage ----- [](#usage) Add the plugin to the panel where you want to use it. If you have multiple panels, ensure you add it to each one. If any panel is not set up correctly, a default Laravel error page will be displayed. ``` ->plugins([ FilamentErrorPagesPlugin::make(), ]) ``` ### Route Configuration [](#route-configuration) In some cases, especially when your panel doesn't have a clear prefix in the URL (like when it's at the root `/`), the plugin might have trouble detecting which panel should handle the error. In these cases, you can explicitly configure which URL patterns should be handled by each panel: ``` ->plugins([ FilamentErrorPagesPlugin::make() ->routes([ 'admin/*', // Will match any path starting with admin/ 'dashboard/*', // Will match any path starting with dashboard/ '/', // Will match the root path 'api/*', // Will match any path starting with api/ ]), ]) ``` This is particularly useful when: - Your panel is mounted at the root URL (`/`) - You have multiple panels with overlapping URL patterns - You want to ensure specific URL patterns are always handled by a particular panel - You have custom routes that don't follow the standard panel prefix pattern The route patterns support the `*` wildcard which matches any characters. For example: - `admin/*` will match `admin/dashboard`, `admin/users`, etc. - `api/*` will match `api/v1`, `api/v2`, etc. - `/` will match the root path ### Restricting to Configured Routes [](#restricting-to-configured-routes) By default, the plugin will try to detect the panel based on the URL path if no explicit routes are configured. You can restrict the plugin to only show error pages for explicitly configured routes: ``` ->plugins([ FilamentErrorPagesPlugin::make() ->routes([ 'admin/*', ]) ->onlyShowForConfiguredRoutes(), ]) ``` When restricted to configured routes, the plugin will only handle errors for URLs that match the explicitly configured routes. This is useful when you want to ensure that error pages are only shown for specific routes and not for all URLs that might match a panel's prefix. ### Health Score 52 — FairBetter than 96% of packages Maintenance78 Regular maintenance activity Popularity41 Moderate usage in the ecosystem Community18 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 84.2% 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 ~36 days Recently: every ~70 days Total 11 Last Release 107d ago Major Versions 1.0.5 → 3.x-dev2025-04-27 PHP version history (2 changes)1.0.0PHP ^8.1 v2.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/6d47a56dfab94e67a7354a146f96a0285c09f6b9d649c558832c6a9b94354b8c?d=identicon)[CodeWithDennis](/maintainers/CodeWithDennis) ![](https://www.gravatar.com/avatar/351e3224dcfda5f2fc1a86fb6424f60a9a060a39c938c6338a244d01912e077d?d=identicon)[kiran1991](/maintainers/kiran1991) ![](https://www.gravatar.com/avatar/805b593a94db583323d21807635f30926e67139922795fe32dcad3852646751a?d=identicon)[spizzo14](/maintainers/spizzo14) --- Top Contributors [![CodeWithDennis](https://avatars.githubusercontent.com/u/23448484?v=4)](https://github.com/CodeWithDennis "CodeWithDennis (48 commits)")[![spizzo14](https://avatars.githubusercontent.com/u/56131020?v=4)](https://github.com/spizzo14 "spizzo14 (5 commits)")[![timsinakiran](https://avatars.githubusercontent.com/u/50225225?v=4)](https://github.com/timsinakiran "timsinakiran (2 commits)")[![sooluh](https://avatars.githubusercontent.com/u/20874779?v=4)](https://github.com/sooluh "sooluh (1 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (1 commits)") --- Tags filamentfilamentphplaravelphplaravelerror-pagesfilament-error-pages ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/cmsmaxinc-filament-error-pages/health.svg) ``` [![Health](https://phpackages.com/badges/cmsmaxinc-filament-error-pages/health.svg)](https://phpackages.com/packages/cmsmaxinc-filament-error-pages) ``` ### Alternatives [guava/calendar Adds support for vkurko/calendar to Filament PHP. 298241.0k3](/packages/guava-calendar)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour Bring the power of DriverJs to your Filament panels and start a tour ! 12247.8k](/packages/jibaymcs-filament-tour)[marcelweidum/filament-expiration-notice Customize the livewire expiration notice 9169.0k4](/packages/marcelweidum-filament-expiration-notice)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle)[outerweb/filament-settings Filament integration for the outerweb/settings package 3690.9k4](/packages/outerweb-filament-settings) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)