PHPackages zvizvi/filament-column-filters - 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. zvizvi/filament-column-filters ActiveLibrary zvizvi/filament-column-filters ============================== Excel-style column header filters for Filament tables, with search, date range and multi-select filter types that sync with regular table filters. 0.0.1(today)00MITPHPPHP ^8.2CI failing Since Jul 23Pushed todayCompare [ Source](https://github.com/zvizvi/filament-column-filters)[ Packagist](https://packagist.org/packages/zvizvi/filament-column-filters)[ Docs](https://github.com/zvizvi/filament-column-filters)[ RSS](/packages/zvizvi-filament-column-filters/feed)WikiDiscussions main Synced today READMEChangelogDependencies (14)Versions (2)Used By (0) [![banner](https://private-user-images.githubusercontent.com/4354421/626064523-46003e9b-27c9-4c1d-b5a1-f608adf0da59.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODQ4NjUzMDMsIm5iZiI6MTc4NDg2NTAwMywicGF0aCI6Ii80MzU0NDIxLzYyNjA2NDUyMy00NjAwM2U5Yi0yN2M5LTRjMWQtYjVhMS1mNjA4YWRmMGRhNTkucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDcyNCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA3MjRUMDM1MDAzWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YTE1NDZhNTc3MmFhYTBkZTBmNmMyNWYzMTNhNWQ0YzIyMGM4ODUxOTAxM2VjMmQ4NTUwNzNjN2NjMDRmNjcwMiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.ghE9Ol0-NwrMTRYIxHQET2aw0emYaokuvpHeuS9_lhI)](https://github.com/zvizvi/filament-column-filters)Filament Column Filters ======================= [](#filament-column-filters) Excel-style column header filters for Filament tables. Adds a small filter icon to the header of any table column. Clicking it opens a popup toolbar — just like the column filters you know from Excel — with a filter type you choose per column: - **Search** — a free-text search on the column. - **Date** — a date range with quick presets (today, yesterday, this week, last week, this month, last month, last 7 days, last 30 days, this year, last year) and a custom from/until range. - **Select** — a single or multi value picker. - **Range** — a numeric from/until range with two number inputs side by side. The header filters are backed by *real* Filament table filters, so they apply to the table query like any other filter and show the standard filter indicators (with working remove buttons) — but they do not clutter the standard filters dropdown. When you **sync with an existing filter** you already have on the table (via `syncWith()`), the popup reads and writes that filter's state, so choosing a value in the header popup updates the regular filter — dropdown included — and vice versa. RTL is fully supported and Hebrew translations are included. Installation ------------ [](#installation) ``` composer require zvizvi/filament-column-filters ``` Register the plugin on each panel that should have column filters. This is required — the `columnFilter()` method and the header popups only become available on panels where the plugin is registered: ``` use Zvizvi\FilamentColumnFilters\FilamentColumnFiltersPlugin; public function panel(Panel $panel): Panel { return $panel->plugin(FilamentColumnFiltersPlugin::make()); } ``` Usage ----- [](#usage) Attach a filter to any table column with the `columnFilter()` method: ``` use Filament\Tables\Columns\TextColumn; use Zvizvi\FilamentColumnFilters\Filters\ColumnFilter; public function table(Table $table): Table { return $table ->columns([ TextColumn::make('user_name') ->label('User Name') ->columnFilter(ColumnFilter::search()), TextColumn::make('created_at') ->label('Date') ->date() ->columnFilter(ColumnFilter::date()), TextColumn::make('status') ->columnFilter( ColumnFilter::select() ->options([ 'open' => 'Open', 'closed' => 'Closed', ]) ->multiple(), ), ]); } ``` That's it. Each configured column gets a filter icon in its header, and a matching filter is automatically registered on the table behind the scenes. The auto-registered filter shows up as a regular filter indicator when active (removable as usual), but it does not appear in the standard filters dropdown — the popup is its only editing UI. If you want it in the dropdown too, define a regular filter yourself and connect the two with `syncWith()`. ### Filter types [](#filter-types) #### Search [](#search) ``` ColumnFilter::search() ->placeholder('Search Name') // optional, defaults to "Search {label}" ``` Performs a `LIKE %value%` search on the column. #### Date [](#date) ``` ColumnFilter::date() ->presets(['today', 'yesterday', 'this_week', 'last_7_days']) // optional, defaults to all presets ->weekStartsOn(0) // 0 = Sunday (default), 1 = Monday ``` Filters records between the chosen `from` / `until` dates (each side optional). The quick-select presets fill the custom range for you. #### Select [](#select) ``` ColumnFilter::select() ->options(['a' => 'Option A', 'b' => 'Option B']) // array or closure ->multiple() // default: true; pass false for single select ->searchable() // force the option search field on (or off with false) ->searchThreshold(8) // options count above which the search field shows automatically (default: 8) ``` When there are many options, a search field appears at the top of the popup to filter the option list (client-side). #### Range [](#range) ``` TextColumn::make('amount') ->columnFilter( ColumnFilter::range() ->step(0.01), // optional step for the number inputs ), ``` Filters records between the entered minimum / maximum values (each side optional). ### Syncing with an existing table filter [](#syncing-with-an-existing-table-filter) If the table already has a regular Filament filter for the same value, the column filter syncs with it instead of registering its own — the header popup reads and writes that filter's state, so both stay in sync and only one indicator shows. This happens **automatically** when a regular filter matches the column: a filter named exactly like the column, or — for `select` filters — any `SelectFilter` on the same attribute. In that case options and single/multiple mode are read from the existing filter too, and no configuration is needed: ``` $table ->columns([ TextColumn::make('status') ->columnFilter(ColumnFilter::select()), // auto-syncs with the "status" filter below ]) ->filters([ SelectFilter::make('status') ->options([...]) ->multiple(), ]); ``` When the names don't line up (or the filter's state keys differ), point the column filter at the right filter by name with `syncWith()`: ``` use Filament\Tables\Filters\SelectFilter; $table ->columns([ TextColumn::make('status') ->columnFilter(ColumnFilter::select()->syncWith('status')), ]) ->filters([ SelectFilter::make('status') ->options([ 'open' => 'Open', 'closed' => 'Closed', ]) ->multiple(), ]); ``` For a `select` sync, the options and single/multiple mode are read automatically from the existing `SelectFilter` (you can still override with `->options()`). For filters with custom form field names, map the popup's fields to your filter's state keys: ``` TextColumn::make('created_at') ->columnFilter( ColumnFilter::date()->syncWith('created', [ 'from' => 'created_from', 'until' => 'created_until', ]), ), // with a regular filter like: Filter::make('created') ->schema([ DatePicker::make('created_from'), DatePicker::make('created_until'), ]) ->query(/* ... */), ``` The `search` filter maps its single field the same way: `->syncWith('name', ['value' => 'q'])`. ### Common options [](#common-options) All filter types support: ``` ColumnFilter::search() ->filterName('my_filter') // name of the auto-registered filter (default: "cf_{column}") ->attribute('some_column') // database column / dotted relation path (default: the column name) ->label('Custom label') // label used for the filter + indicators ->applyUsing(fn (Builder $query, array $data) => $query->where(/* ... */)), // custom query logic ``` Columns whose name contains a dot (e.g. `author.name`) are filtered through the relationship automatically using `whereHas()`. Styling ------- [](#styling) Every colour is exposed as a CSS variable, so you can restyle the trigger and the panel without overriding rules. Declare the ones you want in a stylesheet loaded after the plugin's: ``` :root { --fcf-accent: #7c3aed; /* defaults to the panel's primary colour */ --fcf-trigger-color: #d1d5db; /* header icon, idle */ --fcf-trigger-color-hover: #4b5563; /* header icon, hovered / focused */ } .dark { --fcf-trigger-color: #6b7280; --fcf-panel-bg: #1f2937; } ``` Most variables derive from `--fcf-accent`, so overriding that alone recolours the active icon, the dot, the primary button, the links, the checkboxes and the active date presets. All available variablesVariablePurpose`--fcf-accent` / `--fcf-accent-hover`Accent colour and its hover shade`--fcf-accent-contrast`Text on top of the accent`--fcf-accent-soft` / `--fcf-accent-soft-text`Tinted background and text for active presets`--fcf-trigger-color` / `--fcf-trigger-color-hover`Header icon, idle and hovered`--fcf-trigger-bg-hover`Header icon hover background`--fcf-trigger-color-active` / `--fcf-trigger-color-active-hover`Header icon while the filter is active`--fcf-dot-bg`Active-filter dot`--fcf-panel-bg` / `--fcf-panel-text` / `--fcf-panel-border` / `--fcf-panel-shadow`Panel surface`--fcf-divider`Section and footer separators`--fcf-muted-text` / `--fcf-empty-text`Section titles, field labels, empty states`--fcf-input-bg` / `--fcf-input-text` / `--fcf-input-border`Inputs`--fcf-input-border-focus` / `--fcf-input-ring-focus`Focused inputs`--fcf-control-accent`Checkboxes and radios`--fcf-option-bg-hover`Hovered option row`--fcf-chip-bg` / `--fcf-chip-bg-hover` / `--fcf-chip-border` / `--fcf-chip-text`Date presets`--fcf-chip-active-bg` / `--fcf-chip-active-border` / `--fcf-chip-active-text`Selected date preset`--fcf-btn-bg` / `--fcf-btn-bg-hover` / `--fcf-btn-border` / `--fcf-btn-text`Secondary buttons`--fcf-btn-primary-bg` / `--fcf-btn-primary-bg-hover` / `--fcf-btn-primary-border` / `--fcf-btn-primary-text`Primary button`--fcf-link-color`Text linksTranslations ------------ [](#translations) English and Hebrew translations are included. Publish them to customize: ``` php artisan vendor:publish --tag=filament-column-filters-translations ``` Development ----------- [](#development) ``` npm install npm run build # build resources/dist assets composer test # run the test suite ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 37 — LowBetter than 81% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community8 Small or concentrated contributor base Maturity35 Early-stage or recently created project Bus Factor1 Top contributor holds 62.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 Unknown Total 1 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4354421?v=4)[zvizvi](/maintainers/zvizvi)[@zvizvi](https://github.com/zvizvi) --- Top Contributors [![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (18 commits)")[![zvizvi](https://avatars.githubusercontent.com/u/4354421?v=4)](https://github.com/zvizvi "zvizvi (11 commits)") --- Tags laraveltablefiltersfilamentfilament-pluginfilamentphpzvizvifilament-column-filters ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/zvizvi-filament-column-filters/health.svg) ``` [![Health](https://phpackages.com/badges/zvizvi-filament-column-filters/health.svg)](https://phpackages.com/packages/zvizvi-filament-column-filters) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.8k](/packages/rawilk-profile-filament-plugin)[backstage/mails View logged mails and events in a beautiful Filament UI. 16121.5k](/packages/backstage-mails)[croustibat/filament-jobs-monitor Background Jobs monitoring like Horizon for all drivers for FilamentPHP 274333.4k9](/packages/croustibat-filament-jobs-monitor)[marcelweidum/filament-passkeys Use passkeys in your filamentphp app 6649.5k2](/packages/marcelweidum-filament-passkeys)[biostate/filament-menu-builder An Elegant Menu Builder for FilamentPHP 6528.1k2](/packages/biostate-filament-menu-builder)[schmeits/filament-character-counter This is a Filament character counter TextField and Textarea form field for Filament v4 and v5 34226.4k14](/packages/schmeits-filament-character-counter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)