Empty state

#Overview

The table's "empty state" is rendered when there are no rows in the table.

#Setting the empty state heading

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');
}
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->emptyStateHeading('No posts yet');
}

#Setting the empty state description

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.');
}
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->emptyStateDescription('Once you write your first post, it will appear here.');
}

#Setting the empty state icon

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');
}
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->emptyStateIcon('heroicon-o-bookmark');
}

#Adding empty state actions

You can add Actions to the empty state to prompt users to take action. Pass these to the emptyStateActions() method:

use Filament\Tables\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(),
        ]);
}
use Filament\Tables\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(),
        ]);
}

#Using a custom empty state view

You may use a completely custom empty state view by passing it to the emptyState() method:

use Filament\Tables\Actions\Action;
use Filament\Tables\Table;
 
public function table(Table $table): Table
{
    return $table
        ->emptyState(view('tables.posts.empty-state'));
}
use Filament\Tables\Actions\Action;
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->emptyState(view('tables.posts.empty-state'));
}

Edit on GitHub

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