Skip to main content
Version: Next

Text input column

Introduction​

The text input column allows you to render a text input inside the table, which can be used to update that database record without needing to open a new page or a modal:

use Filament\Tables\Columns\TextInputColumn;

TextInputColumn::make('email')
Text input column

Validation​

You can validate the input by passing any Laravel validation rules in an array:

use Filament\Tables\Columns\TextInputColumn;

TextInputColumn::make('name')
->rules(['required', 'max:255'])

Customizing the HTML input type​

You may use the type() method to pass a custom HTML input type:

use Filament\Tables\Columns\TextInputColumn;

TextInputColumn::make('background_color')->type('color')

Setting the HTML input mode​

You may use the inputMode() method to set the HTML inputmode attribute, which hints at the type of keyboard to show on mobile. For numeric inputs, use inputMode('decimal') for decimal values or inputMode('numeric') for integers:

use Filament\Tables\Columns\TextInputColumn;

TextInputColumn::make('quantity')
->type('number')
->inputMode('decimal')

Setting the numeric step​

When using type('number'), you may use the step() method to set the HTML step attribute. Use step('any') for decimal values or step('1') for integers:

use Filament\Tables\Columns\TextInputColumn;

TextInputColumn::make('quantity')
->type('number')
->inputMode('decimal')
->step('1')

Adding affix text aside the field​

You may place text before and after the input using the prefix() and suffix() methods:

use Filament\Tables\Columns\TextInputColumn;

TextInputColumn::make('domain')
->prefix('https://')
->suffix('.com')
As well as allowing static values, the prefix() and suffix() methods also accept a function to dynamically calculate them. You can inject various utilities into the function as parameters.Learn more about utility injection.
UtilityTypeParameterDescription
ColumnFilament\Tables\Columns\Column$columnThe current column instance.
LivewireLivewire\Component$livewireThe Livewire component instance.
Eloquent record?Illuminate\Database\Eloquent\Model$recordThe Eloquent record for the current table row.
Row loopstdClass$rowLoopThe <a href="https://laravel.com/docs/blade#the-loop-variable" target="_blank">row loop</a> object for the current table row.
Statemixed$stateThe current value of the column, based on the current table row.
TableFilament\Tables\Table$tableThe current table instance.
Text input column with affixes

Using icons as affixes​

You may place an icon before and after the input using the prefixIcon() and suffixIcon() methods:

use Filament\Tables\Columns\TextInputColumn;
use Filament\Support\Icons\Heroicon;

TextInputColumn::make('domain')
->prefixIcon(Heroicon::GlobeAlt)
->suffixIcon(Heroicon::CheckCircle)
As well as allowing static values, the prefixIcon() and suffixIcon() methods also accept a function to dynamically calculate them. You can inject various utilities into the function as parameters.Learn more about utility injection.
UtilityTypeParameterDescription
ColumnFilament\Tables\Columns\Column$columnThe current column instance.
LivewireLivewire\Component$livewireThe Livewire component instance.
Eloquent record?Illuminate\Database\Eloquent\Model$recordThe Eloquent record for the current table row.
Row loopstdClass$rowLoopThe <a href="https://laravel.com/docs/blade#the-loop-variable" target="_blank">row loop</a> object for the current table row.
Statemixed$stateThe current value of the column, based on the current table row.
TableFilament\Tables\Table$tableThe current table instance.
Text input column with prefix icon

Setting the affix icon's color​

Affix icons are gray by default, but you may set a different color using the prefixIconColor() and suffixIconColor() methods:

use Filament\Tables\Columns\TextInputColumn;
use Filament\Support\Icons\Heroicon;

TextInputColumn::make('status')
->suffixIcon(Heroicon::CheckCircle)
->suffixIconColor('success')
As well as allowing static values, the prefixIconColor() and suffixIconColor() methods also accept a function to dynamically calculate them. You can inject various utilities into the function as parameters.Learn more about utility injection.
UtilityTypeParameterDescription
ColumnFilament\Tables\Columns\Column$columnThe current column instance.
LivewireLivewire\Component$livewireThe Livewire component instance.
Eloquent record?Illuminate\Database\Eloquent\Model$recordThe Eloquent record for the current table row.
Row loopstdClass$rowLoopThe <a href="https://laravel.com/docs/blade#the-loop-variable" target="_blank">row loop</a> object for the current table row.
Statemixed$stateThe current value of the column, based on the current table row.
TableFilament\Tables\Table$tableThe current table instance.
Text input column with suffix icon in color

Lifecycle hooks​

Hooks may be used to execute code at various points within the input's lifecycle:

TextInputColumn::make()
->beforeStateUpdated(function ($record, $state) {
// Runs before the state is saved to the database.
})
->afterStateUpdated(function ($record, $state) {
// Runs after the state is saved to the database.
})

Security​

Authorization​

The text input column does not automatically check Laravel Model Policies before saving changes. When a user updates a value via the text input column, Filament checks whether the column is disabled() but does not run any update policy gate check. This means that if a user can see a record in the table and the column is not disabled, they can update that column's value regardless of any update policy you have defined. If you need to restrict who can edit this column, you should use the disabled() method to conditionally prevent editing based on your own authorization logic, for example disabled(fn ($record) => $record->user_id !== auth()->id()). Alternatively, consider using a full edit page or modal action where Filament's resource authorization is enforced.