Columns - Filament

Introduction

Columns define how data is displayed in each row of your table. Filament provides several built-in column types, all located in the Filament\Tables\Columns namespace.

Available column types

Text Column

Display text with formatting, badges, colors, and icons

Icon Column

Show icons or boolean states with customizable colors

Image Column

Display images with various layouts and styles

Color Column

Preview color values as visual swatches

Editable columns

These columns allow users to update data directly in the table:

Select Column

Dropdown selection for quick updates

Toggle Column

Boolean switch for instant toggling

Text Input Column

Inline text editing

Checkbox Column

Checkbox for boolean values

Text Column

The most common column type for displaying text content:

use Filament\Tables\Columns\TextColumn;

TextColumn::make('title')

Formatting text

Colors
Badges
Icons
Dates

Apply colors to text using the color() method:

TextColumn::make('status')
    ->color('primary')

// Dynamic colors
TextColumn::make('status')
    ->color(fn (string $state): string => match ($state) {
        'draft' => 'gray',
        'reviewing' => 'warning',
        'published' => 'success',
        'rejected' => 'danger',
    })

Display text in badge format:

TextColumn::make('status')
    ->badge()
    ->color(fn (string $state): string => match ($state) {
        'draft' => 'gray',
        'reviewing' => 'warning',
        'published' => 'success',
        'rejected' => 'danger',
    })

Add icons to text columns:

use Filament\Support\Enums\IconPosition;
use Filament\Support\Icons\Heroicon;

TextColumn::make('email')
    ->icon(Heroicon::Envelope)
    ->iconPosition(IconPosition::After)
    ->iconColor('primary')

Format dates and times:

TextColumn::make('created_at')
    ->date()

TextColumn::make('created_at')
    ->dateTime()

TextColumn::make('created_at')
    ->time()

// Custom format
TextColumn::make('created_at')
    ->dateTime('F j, Y g:i A')

Text column methods

`badge(bool | Closure $condition = true)`

Display the text as a badge with background color.

`color(string | array | Closure $color)`

Set the text color. Accepts color names like 'primary', 'success', 'danger', etc.

`icon(string | Closure $icon)`

Add an icon to the column.

`iconColor(string | array | Closure $color)`

Set the icon color independently from text color.

`iconPosition(IconPosition | Closure $position)`

Position the icon before or after text.

`date(string $format = null)`

Format the value as a date.

`dateTime(string $format = null)`

Format the value as a date and time.

`time(string $format = null)`

Format the value as a time.

`money(string $currency = 'USD', int $divideBy = 0)`

Format as currency.

`numeric(int $decimalPlaces = 0)`

Format as a number with separators.

`formatStateUsing(Closure $callback)`

Custom formatting function.

`limit(int $length = 100, string $end = '...')`

Truncate long text.

`words(int $words = 100, string $end = '...')`

Limit by word count.

`wrap()`

Allow text to wrap onto multiple lines.

`copyable()`

Add a copy-to-clipboard button.

`description(string | Closure $description)`

Add helper text below the column value.

Icon Column

Display icons or boolean states:

use Filament\Tables\Columns\IconColumn;

IconColumn::make('is_active')
    ->boolean()

Boolean icons

IconColumn::make('is_featured')
    ->boolean()
    ->trueIcon('heroicon-o-check-circle')
    ->falseIcon('heroicon-o-x-circle')
    ->trueColor('success')
    ->falseColor('danger')

Custom icon mappings

use Filament\Support\Icons\Heroicon;

IconColumn::make('status')
    ->icon(fn (string $state): string => match ($state) {
        'draft' => Heroicon::DocumentText,
        'reviewing' => Heroicon::Eye,
        'published' => Heroicon::CheckCircle,
    })
    ->color(fn (string $state): string => match ($state) {
        'draft' => 'gray',
        'reviewing' => 'warning',
        'published' => 'success',
    })

Icon column methods

`boolean(bool | Closure $condition = true)`

Configure as a boolean column.

`trueIcon(string | Closure $icon)`

Icon to display when value is true.

`falseIcon(string | Closure $icon)`

Icon to display when value is false.

`trueColor(string | array | Closure $color)`

Color for true state.

`falseColor(string | array | Closure $color)`

Color for false state.

`size(IconSize | string | Closure $size)`

Set icon size.

Image Column

Display images from storage or URLs:

use Filament\Tables\Columns\ImageColumn;

ImageColumn::make('avatar')
    ->circular()

Image layouts

Circular
Square
Stacked

ImageColumn::make('avatar')
    ->circular()

ImageColumn::make('thumbnail')
    ->square()
    ->imageWidth(64)
    ->imageHeight(64)

ImageColumn::make('team.members.avatar')
    ->circular()
    ->stacked()
    ->limit(3)
    ->limitedRemainingText()

Storage configuration

ImageColumn::make('photo')
    ->disk('s3')
    ->visibility('private')

Image column methods

`circular(bool | Closure $condition = true)`

Display image as a circle.

`square(bool | Closure $condition = true)`

Force square aspect ratio.

`imageWidth(int | string | Closure $width)`

Set image width in pixels.

`imageHeight(int | string | Closure $height)`

Set image height in pixels.

`disk(string | Closure $disk)`

Specify storage disk.

`visibility(string | Closure $visibility)`

Set visibility ('public' or 'private').

`stacked(bool | Closure $condition = true)`

Stack multiple images.

`limit(int | Closure $limit)`

Limit number of visible images.

`limitedRemainingText(bool | Closure $condition = true)`

Show “+X more” text for stacked images.

`defaultImageUrl(string | Closure $url)`

Fallback image when value is null.

Color Column

Display color values as visual swatches:

use Filament\Tables\Columns\ColorColumn;

ColorColumn::make('color')

Copyable colors

ColorColumn::make('color')
    ->copyable()
    ->copyMessage('Color copied')
    ->copyMessageDuration(1500)

Editable Columns

Select Column

Allow inline editing with a dropdown:

use Filament\Tables\Columns\SelectColumn;

SelectColumn::make('status')
    ->options([
        'draft' => 'Draft',
        'reviewing' => 'Reviewing',
        'published' => 'Published',
    ])

Toggle Column

Quick boolean toggle:

use Filament\Tables\Columns\ToggleColumn;

ToggleColumn::make('is_active')

Text Input Column

Inline text editing:

use Filament\Tables\Columns\TextInputColumn;

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

Checkbox Column

Checkbox for boolean values:

use Filament\Tables\Columns\CheckboxColumn;

CheckboxColumn::make('is_featured')

Common column methods

These methods are available on all column types:

`label(string | Closure $label)`

Set the column header label.

`sortable(bool | array | Closure $condition = true)`

Make the column sortable.

`searchable(bool | array | Closure $condition = true)`

Make the column searchable.

`toggleable(bool $condition = true, bool $isToggledHiddenByDefault = false)`

Allow users to show/hide the column.

`alignStart()` / `alignCenter()` / `alignEnd()`

Set horizontal alignment.

`default(mixed $state)`

Default value when state is null.

`placeholder(string | Closure $placeholder)`

Placeholder text for empty values. Add tooltip on hover.

`url(string | Closure $url, bool $shouldOpenInNewTab = false)`

Make column clickable.

`action(Action | Closure $action)`

Trigger an action when clicked.

`width(string | Closure $width)`

Set column width.

`grow(bool $condition = true)`

Allow column to consume extra space.

`hidden(bool | Closure $condition = true)`

Conditionally hide the column.

`visible(bool | Closure $condition = true)`

Conditionally show the column.

Relationships

Access related model data using dot notation:

TextColumn::make('author.name')
TextColumn::make('category.parent.name')

Counting relationships

TextColumn::make('comments_count')
    ->counts('comments')

Checking existence

TextColumn::make('comments_exists')
    ->exists('comments')

Aggregating relationships

TextColumn::make('orders_avg_total')
    ->avg('orders', 'total')
    ->money()

TextColumn::make('orders_sum_total')
    ->sum('orders', 'total')
    ->money()

TextColumn::make('orders_max_total')
    ->max('orders', 'total')
    ->money()

TextColumn::make('orders_min_total')
    ->min('orders', 'total')
    ->money()

Column groups

Group multiple columns under a single heading:

use Filament\Tables\Columns\ColumnGroup;
use Filament\Tables\Columns\IconColumn;
use Filament\Tables\Columns\TextColumn;

ColumnGroup::make('Visibility', [
    TextColumn::make('status'),
    IconColumn::make('is_featured'),
])

Custom columns

Create custom columns using Blade views:

use Filament\Tables\Columns\ViewColumn;

ViewColumn::make('status')
    ->view('filament.tables.columns.status-badge')

In your view file:

<div>
    <x-filament::badge :color="$getState() === 'published' ? 'success' : 'gray'">
        {{ $getState() }}
    </x-filament::badge>
</div>

Getting Started

Panel Builder

Core Concepts

Building Blocks

Advanced

​Introduction

​Available column types

Text Column

Icon Column

Image Column

Color Column

​Editable columns

Select Column

Toggle Column

Text Input Column

Checkbox Column

​Text Column

​Formatting text

​Text column methods

​badge(bool | Closure $condition = true)

​color(string | array | Closure $color)

​icon(string | Closure $icon)

​iconColor(string | array | Closure $color)

​iconPosition(IconPosition | Closure $position)

​date(string $format = null)

​dateTime(string $format = null)

​time(string $format = null)

​money(string $currency = 'USD', int $divideBy = 0)

​numeric(int $decimalPlaces = 0)

​formatStateUsing(Closure $callback)

​limit(int $length = 100, string $end = '...')

​words(int $words = 100, string $end = '...')

​wrap()

​copyable()

​description(string | Closure $description)

​Icon Column

​Boolean icons

​Custom icon mappings

​Icon column methods

​boolean(bool | Closure $condition = true)

​trueIcon(string | Closure $icon)

​falseIcon(string | Closure $icon)

​trueColor(string | array | Closure $color)

​falseColor(string | array | Closure $color)

​size(IconSize | string | Closure $size)

​Image Column

​Image layouts

​Storage configuration

​Image column methods

​circular(bool | Closure $condition = true)

​square(bool | Closure $condition = true)

​imageWidth(int | string | Closure $width)

​imageHeight(int | string | Closure $height)

​disk(string | Closure $disk)

​visibility(string | Closure $visibility)

​stacked(bool | Closure $condition = true)

​limit(int | Closure $limit)

​limitedRemainingText(bool | Closure $condition = true)

​defaultImageUrl(string | Closure $url)

​Color Column

​Copyable colors

​Editable Columns

​Select Column

​Toggle Column

​Text Input Column

​Checkbox Column

​Common column methods

​label(string | Closure $label)

​sortable(bool | array | Closure $condition = true)

​searchable(bool | array | Closure $condition = true)

​toggleable(bool $condition = true, bool $isToggledHiddenByDefault = false)

​alignStart() / alignCenter() / alignEnd()

​default(mixed $state)

​placeholder(string | Closure $placeholder)

​tooltip(string | Closure $tooltip)

​url(string | Closure $url, bool $shouldOpenInNewTab = false)

​action(Action | Closure $action)

​width(string | Closure $width)

​grow(bool $condition = true)

​hidden(bool | Closure $condition = true)

Introduction

Available column types

Editable columns

Text Column

Formatting text

Text column methods

`badge(bool | Closure $condition = true)`

`color(string | array | Closure $color)`

`icon(string | Closure $icon)`

`iconColor(string | array | Closure $color)`

`iconPosition(IconPosition | Closure $position)`

`date(string $format = null)`

`dateTime(string $format = null)`

`time(string $format = null)`

`money(string $currency = 'USD', int $divideBy = 0)`

`numeric(int $decimalPlaces = 0)`

`formatStateUsing(Closure $callback)`

`limit(int $length = 100, string $end = '...')`

`words(int $words = 100, string $end = '...')`

`wrap()`

`copyable()`

`description(string | Closure $description)`

Icon Column

Boolean icons

Custom icon mappings

Icon column methods

`boolean(bool | Closure $condition = true)`

`trueIcon(string | Closure $icon)`

`falseIcon(string | Closure $icon)`

`trueColor(string | array | Closure $color)`

`falseColor(string | array | Closure $color)`

`size(IconSize | string | Closure $size)`

Image Column

Image layouts

Storage configuration

Image column methods

`circular(bool | Closure $condition = true)`

`square(bool | Closure $condition = true)`

`imageWidth(int | string | Closure $width)`

`imageHeight(int | string | Closure $height)`

`disk(string | Closure $disk)`

`visibility(string | Closure $visibility)`

`stacked(bool | Closure $condition = true)`

`limit(int | Closure $limit)`

`limitedRemainingText(bool | Closure $condition = true)`

`defaultImageUrl(string | Closure $url)`

Color Column

Copyable colors

Editable Columns

Select Column

Toggle Column

Text Input Column

Checkbox Column

Common column methods

`label(string | Closure $label)`

`sortable(bool | array | Closure $condition = true)`

`searchable(bool | array | Closure $condition = true)`

`toggleable(bool $condition = true, bool $isToggledHiddenByDefault = false)`

`alignStart()` / `alignCenter()` / `alignEnd()`

`default(mixed $state)`

`placeholder(string | Closure $placeholder)`

`tooltip(string | Closure $tooltip)`

`url(string | Closure $url, bool $shouldOpenInNewTab = false)`

`action(Action | Closure $action)`

`width(string | Closure $width)`

`grow(bool $condition = true)`

`hidden(bool | Closure $condition = true)`

`visible(bool | Closure $condition = true)`

Relationships

Counting relationships

Checking existence

Aggregating relationships

Column groups

Custom columns