> ## Documentation Index > Fetch the complete documentation index at: https://filamentphp.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Select filters export const LaracastsBanner = ({title, description, url, series}) => { const instructors = { 'building-advanced-components': { name: 'Dan Harrin', avatar: 'https://avatars.githubusercontent.com/u/41773797?v=4', twitter: 'https://twitter.com/danjharrin', website: 'https://danharrin.com', github: 'https://github.com/danharrin' }, 'rapid-laravel-development': { name: 'Kevin McKee', avatar: 'https://avatars.githubusercontent.com/u/4503765?v=4', twitter: 'https://twitter.com/iAmKevinMcKee', website: 'https://kevinmckee.me', github: 'https://github.com/iAmKevinMcKee' } }; const instructor = instructors[series] || instructors['building-advanced-components']; return

{title}

{description}

Play Video Laracasts

{instructor.name}

Instructor

; }; export const AutoScreenshot = ({name, alt, version}) => { const [loaded, setLoaded] = useState(false); return

Loading preview

setLoaded(true)} className={`rounded-2xl transition-opacity dark:hidden ${loaded ? 'opacity-100' : 'opacity-0'}`} /> {alt}

setLoaded(true)} className={`hidden rounded-2xl transition-opacity dark:block ${loaded ? 'opacity-100' : 'opacity-0'}`} />

; }; export const EditOnGitHub = ({version, path}) => { const url = `https://github.com/filamentphp/filament/edit/${version}/${path}`; return

Edit this page on GitHub

; }; export const Footer = () => { const sponsorsByTier = JSON.parse(`{ "agency_partner": [ { "name": "Kirschbaum", "url": "https://kirschbaumdevelopment.com/solutions/filament-development", "filename": "kirschbaum.svg" } ], "gold": [ { "name": "Agiledrop", "url": "https://www.agiledrop.com/laravel?utm_source=filament", "filename": "agiledrop.svg" }, { "name": "Baiz.ai", "url": "https://baiz.ai", "filename": "baiz-ai.svg" }, { "name": "CMS Max", "url": "https://cmsmax.com?ref=filamentphp.com", "filename": "cms-max.svg" }, { "name": "Mailtrap", "url": "https://mailtrap.io/email-sending?utm_source=community&utm_medium=referral&utm_campaign=filament", "filename": "mailtrap.svg" }, { "name": "SerpApi", "url": "https://serpapi.com/?utm_source=filamentphp", "filename": "serpapi.svg" } ] }`); function shuffleArray(items) { const result = [...items]; for (let index = result.length - 1; index > 0; index--) { const randomIndex = Math.floor(Math.random() * (index + 1)); [result[index], result[randomIndex]] = [result[randomIndex], result[index]]; } return result; } const sponsors = Object.entries(sponsorsByTier).flatMap(([, sponsors]) => shuffleArray(sponsors)); return

Sponsored by

{sponsors.map(sponsor =>

)} Your logo here

; }; You are currently viewing the documentation for Filament 3.x, which is a previous version of Filament. Looking for the current stable version? Visit the [5.x documentation](/5.x/tables/filters/select). ## Overview Often, you will want to use a [select field](../../forms/fields/select) instead of a checkbox. This is especially true when you want to filter a column based on a set of pre-defined options that the user can choose from. To do this, you can create a filter using the `SelectFilter` class: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('status') ->options([ 'draft' => 'Draft', 'reviewing' => 'Reviewing', 'published' => 'Published', ]) ``` The `options()` that are passed to the filter are the same as those that are passed to the [select field](../../forms/fields/select). ## Customizing the column used by a select filter Select filters do not require a custom `query()` method. The column name used to scope the query is the name of the filter. To customize this, you may use the `attribute()` method: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('status') ->options([ 'draft' => 'Draft', 'reviewing' => 'Reviewing', 'published' => 'Published', ]) ->attribute('status_id') ``` ## Multi-select filters These allow the user to select multiple options to apply the filter to their table. For example, a status filter may present the user with a few status options to pick from and filter the table using. When the user selects multiple options, the table will be filtered to show records that match any of the selected options. You can enable this behavior using the `multiple()` method: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('status') ->multiple() ->options([ 'draft' => 'Draft', 'reviewing' => 'Reviewing', 'published' => 'Published', ]) ``` ## Relationship select filters Select filters are also able to automatically populate themselves based on a relationship. For example, if your table has a `author` relationship with a `name` column, you may use `relationship()` to filter the records belonging to an author: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('author') ->relationship('author', 'name') ``` ### Preloading the select filter relationship options If you'd like to populate the searchable options from the database when the page is loaded, instead of when the user searches, you can use the `preload()` method: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('author') ->relationship('author', 'name') ->searchable() ->preload() ``` ### Customizing the select filter relationship query You may customize the database query that retrieves options using the third parameter of the `relationship()` method: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; use Illuminate\Database\Eloquent\Builder; SelectFilter::make('author') ->relationship('author', 'name', fn (Builder $query) => $query->withTrashed()) ``` ### Searching select filter options You may enable a search input to allow easier access to many options, using the `searchable()` method: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('author') ->relationship('author', 'name') ->searchable() ``` ## Disable placeholder selection You can remove the placeholder (null option), which disables the filter so all options are applied, using the `selectablePlaceholder()` method: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('status') ->options([ 'draft' => 'Draft', 'reviewing' => 'Reviewing', 'published' => 'Published', ]) ->default('draft') ->selectablePlaceholder(false) ``` ## Applying select filters by default You may set a select filter to be enabled by default, using the `default()` method. If using a single select filter, the `default()` method accepts a single option value. If using a `multiple()` select filter, the `default()` method accepts an array of option values: ```php theme={"theme":"gruvbox-dark-hard"} use Filament\Tables\Filters\SelectFilter; SelectFilter::make('status') ->options([ 'draft' => 'Draft', 'reviewing' => 'Reviewing', 'published' => 'Published', ]) ->default('draft') SelectFilter::make('status') ->options([ 'draft' => 'Draft', 'reviewing' => 'Reviewing', 'published' => 'Published', ]) ->multiple() ->default(['draft', 'reviewing']) ```