Column

The Column class is the foundation for all table column components in Filament. It provides functionality for displaying data, sorting, searching, and interacting with table records.

Namespace

Filament\Tables\Columns\Column

Inheritance

Extends: Filament\Support\Components\ViewComponent

Static Methods

make()

Create a new column instance.

public static function make(?string $name = null): static

string | null

The column name, typically corresponding to a database column or model attribute. If null, the column class must define getDefaultName().

static

Returns the column instance for method chaining.

Example:

use Filament\Tables\Columns\TextColumn;

TextColumn::make('name')
    ->sortable()
    ->searchable();

getDefaultName()

Get the default name for the column.

public static function getDefaultName(): ?string

string | null

Returns the default column name or null.

Instance Methods

getTable()

Get the table instance this column belongs to.

public function getTable(): Table

Table

Returns the parent table instance.

getState()

Get the current state/value for this column.

public function getState(): mixed

mixed

Returns the column value for the current record.

getRecord()

Get the current record.

public function getRecord(): ?Model

Model | null

Returns the Eloquent model instance for the current row.

getLivewire()

Get the Livewire component instance.

public function getLivewire(): Component

Component

Returns the parent Livewire component.

renderInLayout()

Render the column within a layout (for split layouts).

public function renderInLayout(): ?HtmlString

HtmlString | null

Returns the rendered HTML or null if hidden.

Display Methods

label()

Set the column label (header).

public function label(string | Htmlable | Closure | null $label): static

string | Htmlable | Closure | null

The column header label.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('created_at')
    ->label('Date Created');

placeholder()

Set a placeholder when the column value is empty.

public function placeholder(string | Htmlable | Closure | null $placeholder): static

string | Htmlable | Closure | null

The placeholder text to display when the value is empty.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('description')
    ->placeholder('No description');

alignment()

Set the column alignment.

public function alignment(Alignment | string | Closure | null $alignment): static

Alignment | string | Closure | null

The alignment (start, center, end).

static

Returns the column instance for method chaining.

Example:

use Filament\Support\Enums\Alignment;

TextColumn::make('price')
    ->alignment(Alignment::End);

width()

Set the column width.

public function width(string | Closure | null $width): static

string | Closure | null

The width (e.g., ‘200px’, ‘20%’).

static

Returns the column instance for method chaining.

Example:

TextColumn::make('actions')
    ->width('100px');

grow()

Allow the column to grow to fill available space.

public function grow(bool | Closure $condition = true): static

bool | Closure

default:"true"

Whether the column should grow.

static

Returns the column instance for method chaining.

Searching and Sorting

searchable()

Make the column searchable.

public function searchable(
    bool | array | Closure $condition = true,
    ?Closure $query = null,
    bool $isIndividual = false
): static

bool | array | Closure

default:"true"

Whether the column is searchable, or an array of searchable database columns.

Closure | null

Custom search query callback.

bool

default:"false"

Whether to use individual column search.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('name')
    ->searchable();

// Search multiple columns
TextColumn::make('name')
    ->searchable(['first_name', 'last_name']);

sortable()

Make the column sortable.

public function sortable(bool | array | Closure $condition = true, ?Closure $query = null): static

bool | array | Closure

default:"true"

Whether the column is sortable, or an array of database columns to sort by.

Closure | null

Custom sort query callback.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('created_at')
    ->sortable();

Actions and URLs

action()

Set an action to trigger when the column is clicked.

public function action(Action | Closure | null $action): static

Action | Closure | null

The action to execute or a callback returning an action name.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('name')
    ->action(fn () => 'edit');

url()

Set a URL for the column.

public function url(string | Closure | null $url, bool | Closure $shouldOpenInNewTab = false): static

string | Closure | null

The URL or a callback returning a URL.

bool | Closure

default:"false"

Whether to open the URL in a new tab.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('website')
    ->url(fn (Model $record) => $record->website, shouldOpenInNewTab: true);

Visibility Control

hidden()

Hide the column based on a condition.

public function hidden(bool | Closure $condition = true): static

Example:

TextColumn::make('internal_notes')
    ->hidden(fn () => ! auth()->user()->isAdmin());

toggleable()

Allow users to toggle column visibility.

public function toggleable(bool | Closure $condition = true, bool | Closure $isToggledHiddenByDefault = false): static

bool | Closure

default:"true"

Whether the column is toggleable.

bool | Closure

default:"false"

Whether the column is hidden by default.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('updated_at')
    ->toggleable(isToggledHiddenByDefault: true);

Summarization

summarize()

Add summary calculations to the column.

public function summarize(Summarizer | array | Closure $summarizers): static

Summarizer | array | Closure

One or more summarizer instances or a callback returning summarizers.

static

Returns the column instance for method chaining.

Example:

use Filament\Tables\Columns\Summarizers\Sum;
use Filament\Tables\Columns\Summarizers\Average;

TextColumn::make('price')
    ->summarize([
        Sum::make(),
        Average::make(),
    ]);

Tooltips

Add a tooltip to the column.

public function tooltip(string | Htmlable | Closure | null $tooltip): static

The tooltip content.

static

Returns the column instance for method chaining.

Example:

TextColumn::make('status')
    ->tooltip(fn (Model $record) => "Last updated: {$record->updated_at}");

Traits

The Column class uses multiple traits for functionality:

BelongsToGroup - Column group relationship
BelongsToLayout - Layout relationship
BelongsToTable - Table relationship
CanAggregateRelatedModels - Relationship aggregation
CanBeDisabled - Disability control
CanBeHidden - Visibility control
CanBeInline - Inline display
CanBeSearchable - Search functionality
CanBeSortable - Sorting functionality
CanBeSummarized - Summary calculations
CanBeToggled - Toggle visibility
CanCallAction - Action triggering
CanGrow - Growth control
CanOpenUrl - URL handling
CanSpanColumns - Column spanning
CanWrapHeader - Header wrapping
HasAlignment - Alignment control
HasCellState - Cell state management
HasExtraAttributes - Extra HTML attributes
HasExtraCellAttributes - Cell-specific attributes
HasExtraHeaderAttributes - Header-specific attributes
HasLabel - Label configuration
HasName - Name configuration
HasPlaceholder - Placeholder support
HasRecord - Record access
HasRowLoopObject - Row loop access
HasTooltip - Tooltip support
HasVerticalAlignment - Vertical alignment
HasWidth - Width control
InteractsWithTableQuery - Query interaction

Table - Table builder
Filter - Table filters
Action - Column actions

Core Classes

Form Builder

Table Builder

Actions

Namespace

Inheritance

Static Methods

make()

getDefaultName()

Instance Methods

getTable()

getState()

getRecord()

getLivewire()

renderInLayout()

Display Methods

label()

placeholder()

alignment()

width()

grow()

Searching and Sorting

searchable()

sortable()

Actions and URLs

action()

url()

Visibility Control

hidden()

toggleable()

Summarization

summarize()

Tooltips

tooltip()

Traits

​Namespace

​Inheritance

​Static Methods

​make()

​getDefaultName()

​Instance Methods

​getTable()

​getState()

​getRecord()

​getLivewire()

​renderInLayout()

​Display Methods

​label()

​placeholder()

​alignment()

​width()

​grow()

​Searching and Sorting

​searchable()

​sortable()

​Actions and URLs

​action()

​url()

​Visibility Control

​hidden()

​toggleable()

​Summarization

​summarize()

​Tooltips

​tooltip()

​Traits

​Related Classes

Namespace

Inheritance

Static Methods

make()

getDefaultName()

Instance Methods

getTable()

getState()

getRecord()

getLivewire()

renderInLayout()

Display Methods

label()

placeholder()

alignment()

width()

grow()

Searching and Sorting

searchable()

sortable()

Actions and URLs

action()

url()

Visibility Control

hidden()

toggleable()

Summarization

summarize()

Tooltips

tooltip()

Traits

Related Classes