Tables Laravel Package

title: Empty state

import AutoScreenshot from "@components/AutoScreenshot.astro"

Introduction

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');
}

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.');
}

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');
}

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\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\Table;

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