Table toolbarActions/headerActions record() not accessible in action callback

[AsmitNepali]

Package

filament/filament

Package Version

v4.0.6

Laravel Version

v12.28.0

Livewire Version

v3.6.4

PHP Version

PHP 8.4

Problem description

Description

When using ->record() on table toolbarActions or headerActions, the explicitly set record is not accessible in the action callback. The record parameter shows as null instead of the expected model instance.

Expected behavior

Expected Behavior

The $record parameter in the action callback should contain the Student model instance returned from Student::first().

Actual Behavior

The $record parameter is null.

Steps to reproduce

1. Create a table with toolbarActions or headerActions
2. Use ->record() to explicitly set a record
3. Try to access the record in the action callback
4. Observe that the record parameter is null

Code Example

use App\Models\Student;
use Filament\Actions\Action;

public static function table(Table $table): Table
{
    return $table
        ->toolbarActions([
            Action::make('test')
                ->record(fn() => Student::first())  // Explicitly setting record
                ->action(fn($record) => dd($record)),      // $record is null here
        ]);
}

Reproduction repository (issue will be closed if this is not valid)

https://github.com/AsmitNepali/course-file/blob/77358006d55ff37aca472a51694f104105433b8b/app/Filament/Resources/Students/StudentResource.php#L44

Relevant log output

[rohanAdhikari1]

Hello @AsmitNepali,
The ->record() method does not accept a $record argument in its callback. It only expects a closure that returns the model instance directly. You can try updating your code as follow:

Action::make('test')
                ->record(fn() => Student::first()) 
                ->action(fn($record) => dd($record)),

This might correctly resolve the record and pass it into the action callback.

[AsmitNepali]

Hello
@rohanAdhikari1 Thank for noticing that, I tried it with this snippet:

 ->toolbarActions([
                Action::make('record')
                    ->record(fn() => Student::first())
                    ->action(fn($record) => dd($record))
                    ])

There are two cases here:

1. When a filter is applied and no records are returned → it resolves to null.
2. When the table has records → it resolves the record correctly.

Screen.Recording.2025-09-07.at.15.50.35.mov

[rohanAdhikari1]

@AsmitNepali ,
I may be wrong, but I think actions inside a table context will only inject $record if the record exists in the table’s query results.

Even if you explicitly provide a record in a toolbarActions() action, it won’t be accessible if that record isn’t part of the table.

Provided snippet work only if the returned record (Student::first()) is also present in the table. Otherwise, $record will be null.

If you want to explicitly set a record and always access it regardless of whether it’s in the table, you can define the action at the List page level (e.g., in getHeaderActions()):

class ListStudents extends ListRecords
{
   ....

    protected function getHeaderActions(): array
    {
        return [
            CreateAction::make(),
            Action::make('test2')
                ->record(fn() => Student::first())
                ->action(function ($record) {
                    dd($record);
                }),
        ];
......

That way, the record is always passed in, even if it doesn’t appear in the table’s dataset.