packages/tables/docs/08-empty-state.md
import AutoScreenshot from "@components/AutoScreenshot.astro"
The table's "empty state" is rendered when there are no rows in the table.
<AutoScreenshot name="tables/empty-state" alt="Table with empty state" version="5.x" />To customize the heading of the empty state, use the emptyStateHeading() method:
use Filament\Tables\Table;
public function table(Table $table): Table
{
return $table
->emptyStateHeading('No posts yet');
}
To customize the description of the empty state, use the emptyStateDescription() method:
use Filament\Tables\Table;
public function table(Table $table): Table
{
return $table
->emptyStateDescription('Once you write your first post, it will appear here.');
}
To customize the icon of the empty state, use the emptyStateIcon() method:
use Filament\Tables\Table;
public function table(Table $table): Table
{
return $table
->emptyStateIcon('heroicon-o-bookmark');
}
You can add Actions to the empty state to prompt users to take action. Pass these to the emptyStateActions() method:
use Filament\Actions\Action;
use Filament\Tables\Table;
public function table(Table $table): Table
{
return $table
->emptyStateActions([
Action::make('create')
->label('Create post')
->url(route('posts.create'))
->icon('heroicon-m-plus')
->button(),
]);
}
You may use a completely custom empty state view by passing it to the emptyState() method:
use Filament\Tables\Table;
public function table(Table $table): Table
{
return $table
->emptyState(view('tables.posts.empty-state'));
}