Download the PHP package happenv-com/filament-saved-views without Composer

Filament Saved Views

Reusable, per-user saved views for Filament list tables. Let users capture the current table state (filters, search, sort, grouping, per-page and toggled columns) as a named view, then reopen it in one click — with a management UI styled to match Filament's own column manager.

The package is framework-agnostic: it ships an auto-increment-keyed model and binds everything through the service container, so a host application can swap in its own model (e.g. UUID keys, multi-tenant) without touching the package.

Key features

• Save the current view. Capture the complete table state of any resource list table — filters, search, per-column searches, sort, grouping, per-page, and the column layout including its order.
• Update the open view. Arranging a table while a view is open does not change the view; an explicit "Update this view" button, shown only when there is something to write, writes the current state over it, and a dot on the manager trigger says the table has unsaved changes.
• A saved-views manager. A toolbar control (dropdown / modal / slide-over) lists a user's views, mirroring the look and spacing of Filament's column manager — see Configure the manager per table.
• Reorder, rename and delete. Views are reordered by drag-and-drop, renamed inline and deleted from the manager.
• Submenu visibility. A per-view checkbox controls whether the view appears in the page's sub-navigation (via the optional HasSavedViews trait) — see Add the trait to your list pages.
• Deferred mode. Opt in with deferSavedViewManager() to stage changes and commit them with an "Apply saved views" action, just like deferColumnManager().
• Per-user scoping. Views belong to the signed-in user, and view names are unique per user and resource.
• 64 languages. The manager is translated into every locale Filament ships — see Translations.
• Configurable icons and a swappable model. Heroicons by default, any icon Filament accepts instead, and a model resolved from the container — see Swapping the model.

Requirements

Installation

Install the package via Composer:

Publish and run the migration that creates the saved_views table:

Publish the package assets (registers the manager stylesheet):

[!IMPORTANT] If you have not set up a custom theme and are using Filament Panels, follow the instructions in the Filament docs first.

Add the package's views to your theme's CSS file, so Tailwind generates the classes they use:

Register the plugin in your panel provider — see Usage.

Configuration

Optionally publish the config file:

config/filament-happenv-saved-views.php:

Optionally, publish the views and translations:

Swapping the model

Every model reference is resolved through the container and bound with bindIf, so a host app can provide its own model (different keys, traits, connection):

Point the package at the host table via config('filament-happenv-saved-views.table') and override icons the same way (any value Filament accepts as an icon, including other icon-set enums).

Usage

1. Register the plugin on a panel

The plugin injects the saved-views control into the toolbar of every resource list page that uses the HasSavedViews trait.

2. Add the trait to your list pages

Surface the saved views in the page sub-navigation:

3. Restyle the manager button (optional)

The toolbar button is a SavedViewManagerAction, so it configures the way any Filament component does — once, for every table:

Your callback runs after the package's own defaults, so anything you set wins. A broad Action::configureUsing() registered against the parent still runs earlier, so a panel-wide default does not quietly repaint this one button.

4. Configure the manager per table (optional)

Translations

The manager ships in every locale Filament ships:

am ar az bg bn bs ca ckb cs da de el en es et eu fa fi fil fr he hi hr hu hy id it ja ka km ko ku lt lus lv mk mn ms my nb ne nl pl pt pt_BR ro ru sk sl sq sr_Cyrl sr_Latn sv sw tg th tr uk ur uz vi zh_CN zh_HK zh_TW

Publish them with php artisan vendor:publish --tag="filament-saved-views-translations" to change the wording or add a language. tests/Unit/TranslationsTest.php checks that every locale has exactly the keys English has, and that every locale Filament ships has a translation.

Development

The stylesheet (resources/css/saved-views.css) is plain CSS registered with FilamentAsset — there is no build step.

Upgrading

Breaking changes and how to migrate are described in UPGRADING for every major version.

Changelog

See CHANGELOG and GitHub releases for what has changed recently.

Contributing

See CONTRIBUTING for details.

Security vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Happenv sp. z o.o.
• webard
• All contributors

License

The MIT License (MIT). See License File for more information.