Getting Started

Resources

Resources are static classes that are used to build CRUD interfaces for your Eloquent models. They describe how administrators should be able to interact with data from your app - using tables and forms.

Creating a resource

To create a resource for the App\Models\Customer model:

php artisan make:filament-resource Customer

This will create several files in the app/Filament/Resources directory:

.
+-- CustomerResource.php
+-- CustomerResource
| +-- Pages
| | +-- CreateCustomer.php
| | +-- EditCustomer.php
| | +-- ListCustomers.php

Your new resource class lives in CustomerResource.php.

The classes in the Pages directory are used to customize the pages in the admin panel that interact with your resource. They're all full-page Livewire components that you can customize in any way you wish.

Have you created a resource, but it's not appearing in the navigation menu? If you have a model policy, make sure you return true from the viewAny() method.

Simple (modal) resources

Sometimes, your models are simple enough that you only want to manage records on one page, using modals to create, edit and delete records. To generate a simple resource with modals:

php artisan make:filament-resource Customer --simple

Your resource will have a "Manage" page, which is a List page with modals added.

Additionally, your simple resource will have no getRelations() method, as relation managers are only displayed on the Edit and View pages, which are not present in simple resources. Everything else is the same.

Automatically generating forms and tables

If you'd like to save time, Filament can automatically generate the form and table for you, based on your model's database columns.

The doctrine/dbal package is required to use this functionality:

composer require doctrine/dbal

When creating your resource, you may now use --generate:

php artisan make:filament-resource Customer --generate

Handling soft deletes

By default, you will not be able to interact with deleted records in the admin panel. If you'd like to add functionality to restore, force delete and filter trashed records in your resource, use the --soft-deletes flag when generating the resource:

php artisan make:filament-resource Customer --soft-deletes

Generating a View page

By default, only List, Create and Edit pages are generated for your resource. If you'd also like a View page, use the --view flag:

php artisan make:filament-resource Customer --view

Record titles

A $recordTitleAttribute may be set for your resource, which is the name of the column on your model that can be used to identify it from others.

For example, this could be a blog post's title or a customer's name:

protected static ?string $recordTitleAttribute = 'name';

This is required for features like global search to work.

You may specify the name of an Eloquent accessor if just one column is inadequate at identifying a record.

Forms

Resource classes contain a static form() method that is used to build the forms on the Create and Edit pages:

use Filament\Forms;
use Filament\Resources\Form;
 
public static function form(Form $form): Form
{
return $form
->schema([
Forms\Components\TextInput::make('name')->required(),
Forms\Components\TextInput::make('email')->email()->required(),
// ...
]);
}

Fields

The schema() method is used to define the structure of your form. It is an array of fields, in the order they should appear in your form.

We have many fields available for your forms, including:

To view a full list of available form fields, see the Form Builder documentation.

You may also build your own completely custom form fields.

Layout

Form layouts are completely customizable. We have many layout components available, which can be used in any combination:

To view a full list of available layout components, see the Form Builder documentation.

You may also build your own completely custom layout components.

Hiding components based on the page

The hiddenOn() method of form components allows you to dynamically hide fields based on the current page.

In this example, we hide the password field on the EditUser resource page:

use Livewire\Component;
 
Forms\Components\TextInput::make('password')
->password()
->required()
->hiddenOn(Pages\EditUser::class),

Alternatively, we have a visibleOn() shortcut method for only showing a field on one page:

use Livewire\Component;
 
Forms\Components\TextInput::make('password')
->password()
->required()
->visibleOn(Pages\CreateUser::class),

Tables

Resource classes contain a static table() method that is used to build the table on the List page:

use Filament\Resources\Table;
use Filament\Tables;
use Illuminate\Database\Eloquent\Builder;
 
public static function table(Table $table): Table
{
return $table
->columns([
Tables\Columns\TextColumn::make('name'),
Tables\Columns\TextColumn::make('email'),
// ...
])
->filters([
Tables\Filters\Filter::make('verified')
->query(fn (Builder $query): Builder => $query->whereNotNull('email_verified_at')),
// ...
])
->actions([
Tables\Actions\EditAction::make(),
])
->bulkActions([
Tables\Actions\DeleteBulkAction::make(),
]);
}

Check out the listing records docs to find out how to add table columns, filters, actions, bulk actions and more.

Relations

Filament has many utilities available for managing resource relationships. Which solution you choose to use depends on your use case:

BelongsTo

Select field

Filament includes the ability automatically loads options from a BelongsTo relationship:

use Filament\Forms\Components\Select;
 
Select::make('author_id')
->relationship('author', 'name')

More information is available in the Form docs.

Layout component

Layout form components are able to save child data to relationships, such as BelongsTo:

use Filament\Forms\Components\Fieldset;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
 
Fieldset::make('Author')
->relationship('author')
->schema([
TextInput::make('name')->required(),
Textarea::make('bio'),
])

For more information, see the Form docs.

HasOne

Layout component

Layout form components are able to save child data to relationships, such as HasOne:

use Filament\Forms\Components\Fieldset;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
 
Fieldset::make('Metadata')
->relationship('metadata')
->schema([
TextInput::make('title'),
Textarea::make('description'),
FileUpload::make('image'),
])

For more information, see the Form docs.

HasMany

Relation manager

"Relation managers" in Filament allow admins to list, create, associate, edit, dissociate and delete related records without leaving the resource's Edit page.

The related records are listed in a table, which has buttons to open a modal for each action.

For more information on relation managers, see the full documentation.

Repeater

Alternatively, if you're looking to edit the relationship from the main form, you could use a repeater:

use Filament\Forms\Components\Repeater;
 
Repeater::make('qualifications')
->relationship()
->schema([
// ...
])

From a UX perspective, this solution is only suitable if your related model only has a few fields. Otherwise, the form can get very long.

HasManyThrough

Relation manager

"Relation managers" in Filament allow admins to list, create, associate, edit, dissociate and delete related records without leaving the resource's Edit page.

The related records are listed in a table, which has buttons to open a modal for each action.

For more information on relation managers, see the full documentation.

BelongsToMany

Multi-select field

Filament can automatically load MultiSelect options from a BelongsToMany relationship:

use Filament\Forms\Components\MultiSelect;
 
MultiSelect::make('technologies')
->relationship('technologies', 'name')

More information about BelongsToManyMultiSelect is available in the Form docs.

Checkbox list field

Filament can automatically load CheckboxList options from a BelongsToMany relationship:

use Filament\Forms\Components\CheckboxList;
 
CheckboxList::make('technologies')
->relationship('technologies', 'name')

More information about CheckboxList is available in the Form docs.

Relation manager

"Relation managers" in Filament allow admins to list, create, attach, edit, detach and delete related records without leaving the resource's Edit page.

The related records are listed in a table, which has buttons to open a modal for each action.

For more information on relation managers, see the full documentation.

MorphOne

Layout component

Layout form components are able to save child data to relationships, such as MorphOne:

use Filament\Forms\Components\Fieldset;
use Filament\Forms\Components\FileUpload;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
 
Fieldset::make('Metadata')
->relationship('metadata')
->schema([
TextInput::make('title'),
Textarea::make('description'),
FileUpload::make('image'),
])

For more information, see the Form docs.

MorphMany

Relation manager

"Relation managers" in Filament allow admins to list, create, associate, edit, dissociate and delete related records without leaving the resource's Edit page.

The related records are listed in a table, which has buttons to open a modal for each action.

For more information on relation managers, see the full documentation.

Repeater

Alternatively, if you're looking to edit the relationship from the main form, you could use a repeater:

use Filament\Forms\Components\Repeater;
 
Repeater::make('qualifications')
->schema([
// ...
])

From a UX perspective, this solution is only suitable if your related model only has a few fields. Otherwise, the form can get very long.

MorphToMany

Relation manager

"Relation managers" in Filament allow admins to list, create, attach, edit, detach and delete related records without leaving the resource's Edit page.

The related records are listed in a table, which has buttons to open a modal for each action.

For more information on relation managers, see the full documentation.

Authorization

For authorization, Filament will observe any model policies that are registered in your app. The following methods are used:

  • viewAny() is used to completely hide resources from the navigation menu, and prevents the user from accessing any pages.
  • create() is used to control creating new records.
  • update() is used to control editing a record.
  • delete() is used to prevent a single record from being deleted. deleteAny() is used to prevent records from being bulk deleted. Filament uses the deleteAny() method because iterating through multiple records and checking the delete() policy is not very performant.
  • view() is used to control viewing a record.

Model labels

Each resource has a "model label" which is automatically generated from the model name. For example, an App\Models\Customer model will have a customer label.

The label is used in several parts of the UI, and you may customise it using the $modelLabel property:

protected static ?string $modelLabel = 'cliente';

Alternatively, you may use the getModelLabel() to define a dynamic label:

public static function getModelLabel(): string
{
return __('filament/resources/customer.label');
}

Plural model label

Resources also have a "plural model label" which is automatically generated from the model label. For example, a customer label will be pluralized into customers.

You may customize the plural version of the label using the $pluralModelLabel property:

protected static ?string $pluralModelLabel = 'clientes';

Alternatively, you may set a dynamic plural label in the getPluralModelLabel() method:

public static function getPluralModelLabel(): string
{
return __('filament/resources/customer.plural_label');
}

Navigation

Filament will automatically generate a navigation menu item for your resource using the plural label.

If you'd like to customize the navigation item label, you may use the $navigationLabel property:

protected static ?string $navigationLabel = 'Mis Clientes';

Alternatively, you may set a dynamic navigation label in the getNavigationLabel() method:

public static function getNavigationLabel(): string
{
return __('filament/resources/customer.navigation_label');
}

Icons

The $navigationIcon property supports the name of any Blade component. By default, the Blade Heroicons package is installed, so you may use the name of any Heroicon out of the box. However, you may create your own custom icon components or install an alternative library if you wish.

protected static ?string $navigationIcon = 'heroicon-o-user-group';

Alternatively, you may set a dynamic navigation icon in the getNavigationIcon() method:

public static function getNavigationIcon(): string
{
return 'heroicon-o-user-group';
}

Sorting navigation items

The $navigationSort property allows you to specify the order in which navigation items are listed:

protected static ?int $navigationSort = 2;

Alternatively, you may set a dynamic navigation item order in the getNavigationSort() method:

public static function getNavigationSort(): ?int
{
return 2;
}

Grouping navigation items

You may group navigation items by specifying a $navigationGroup property:

protected static ?string $navigationGroup = 'Shop';

Alternatively, you may use the getNavigationGroup() method to set a dynamic group label:

protected static function getNavigationGroup(): ?string
{
return return __('filament/navigation.groups.shop');
}

Customising the Eloquent query

Within Filament, every query to your resource model will start with the getEloquentQuery() method.

Because of this, it's very easy to apply your own model scopes that affect the entire resource. You can use this to implement multi-tenancy easily within the admin panel.

Disabling global scopes

By default, Filament will observe all global scopes that are registered to your model. However, this may not be ideal if you wish to access, for example, soft deleted records.

To overcome this, you may override the getEloquentQuery() method that Filament uses:

public static function getEloquentQuery(): Builder
{
return parent::getEloquentQuery()->withoutGlobalScopes();
}

Alternatively, you may remove specific global scopes:

public static function getEloquentQuery(): Builder
{
return parent::getEloquentQuery()->withoutGlobalScopes([ActiveScope::class]);
}

More information about removing global scopes may be found in the Laravel documentation.

Multi-tenancy

Multi-tenancy, simply, is the concept of users "owning" records, and only being able to access the records that they own within Filament.

Simple multi-tenancy from scratch

Simple multi-tenancy is easy to set up with Filament.

First, scope the base Eloquent query for every "owned" resource by defining the getEloquentQuery() method:

public static function getEloquentQuery(): Builder
{
return parent::getEloquentQuery()->whereBelongsTo(auth()->user());
}

In this example we use whereBelongsTo() to scope the records to only those that belong to the currently authenticated user. However, you may use whatever Eloquent method you wish here, including a manual where() clause, or a scope.

Finally, you need to ensure that records are attached to the current user when they are first created. The easiest way to do this is through a model observer:

public function creating(Post $post): void
{
$post->user()->associate(auth()->user());
}

stancl/tenancy

To set up stancl/tenancy to work with Filament, you just need to add the InitializeTenancyByDomain::class middleware to Livewire and the Filament config file:

use Stancl\Tenancy\Middleware\InitializeTenancyByDomain;
 
'middleware' => [
// ...
'base' => [
// ...
InitializeTenancyByDomain::class
],
],

Deleting pages

If you'd like to delete a page from your resource, you can just delete the page file from the Pages directory of your resource, and its entry in the getPages() method.

For example, you may have a resource with records that may not be created by anyone. Delete the Create page file, and then remove it from getPages():

public static function getPages(): array
{
return [
'index' => Pages\ListCustomers::route('/'),
'edit' => Pages\EditCustomer::route('/{record}/edit'),
];
}

Still need help? Join our Discord community or open a GitHub discussion

Enjoying Filament?

We are open source at heart. To allow us to build new features, fix bugs, and run the community, we require your financial support.

Sponsor Filament on GitHub