Customization: Columns - Datatables for Laravel [ Datatables for Laravel ](/) Toggle main menu [Docs](https://laravel-datatables.com/docs) [Demos](/demos) [Blog](https://laravel-datatables.com/blog) [Pricing](/pricing) Search ⌘ K [ Log in ](/login) [Docs](https://laravel-datatables.com/docs) [Demos](/demos) [Blog](https://laravel-datatables.com/blog) [Pricing](/pricing) Search docs and demos Type at least 2 characters to search. Documentation menu ### Getting Started - [ Installation ](https://laravel-datatables.com/docs) - [ Dark Mode ](https://laravel-datatables.com/docs/dark-mode) ### Basics - [ Creating a Table ](https://laravel-datatables.com/docs/creating-a-table) - [ Displaying Columns ](https://laravel-datatables.com/docs/displaying-columns) - [ Data Sources ](https://laravel-datatables.com/docs/data-sources) - [ Internationalisation ](https://laravel-datatables.com/docs/internationalisation) - [ Multi-Language ](https://laravel-datatables.com/docs/multi-language) - [ Styling ](https://laravel-datatables.com/docs/styling) ### Customization - [ Columns ](https://laravel-datatables.com/docs/customization-columns) - [ Cell Renderer ](https://laravel-datatables.com/docs/customization-cell-renderer) - [ Value Formatter ](https://laravel-datatables.com/docs/customization-value-formatter) - [ Filters ](https://laravel-datatables.com/docs/customization-filters) - [ Pagination ](https://laravel-datatables.com/docs/customization-pagination) - [ Sorting Icons ](https://laravel-datatables.com/docs/customization-sorting-icons) - [ Row Actions ](https://laravel-datatables.com/docs/customization-row-actions) - [ Multi Row Actions ](https://laravel-datatables.com/docs/customization-multi-row-actions) - [ Loading Indicator ](https://laravel-datatables.com/docs/customization-loading-indicator) - [ Exporting ](https://laravel-datatables.com/docs/customization-exporting) - [ Components ](https://laravel-datatables.com/docs/customization-components) - [ Data Sources ](https://laravel-datatables.com/docs/customization-data-sources) - [ State Persistence ](https://laravel-datatables.com/docs/customization-state-persistence) ### Features - [ Accessibility ](https://laravel-datatables.com/docs/feature-accessibility) - [ Actions and Forms ](https://laravel-datatables.com/docs/actions-and-forms) - [ Aggregate Columns ](https://laravel-datatables.com/docs/feature-aggregate-columns) - [ Column Reordering ](https://laravel-datatables.com/docs/feature-column-reordering) - [ Column Visibility ](https://laravel-datatables.com/docs/feature-column-visibility) - [ Custom Filters ](https://laravel-datatables.com/docs/feature-custom-filters) - [ Custom Controls ](https://laravel-datatables.com/docs/feature-custom-controls) - [ Exporting ](https://laravel-datatables.com/docs/feature-exporting) - [ Freeze Columns and Headers ](https://laravel-datatables.com/docs/feature-freeze-columns-and-headers) - [ Pagination ](https://laravel-datatables.com/docs/feature-pagination) - [ Responsive Mobile ](https://laravel-datatables.com/docs/feature-responsive-mobile) - [ Row Grouping ](https://laravel-datatables.com/docs/feature-row-grouping) - [ Row Selection ](https://laravel-datatables.com/docs/feature-row-selection) - [ Sorting and Searching ](https://laravel-datatables.com/docs/sorting-and-searching) - [ State Persistence ](https://laravel-datatables.com/docs/feature-state-persistence) - [ Value Preparation ](https://laravel-datatables.com/docs/feature-value-preparation) ### Cell Renderer - [ Action Buttons ](https://laravel-datatables.com/docs/renderer-action-buttons) - [ Avatar ](https://laravel-datatables.com/docs/renderer-avatar) - [ Checkmark ](https://laravel-datatables.com/docs/renderer-checkmark) - [ Color Sample ](https://laravel-datatables.com/docs/renderer-color-sample) - [ Email Link ](https://laravel-datatables.com/docs/renderer-email-to-link) - [ External Link ](https://laravel-datatables.com/docs/renderer-external-link) - [ Friendly Timestamp ](https://laravel-datatables.com/docs/renderer-friendly-timestamp) - [ Image ](https://laravel-datatables.com/docs/renderer-image) - [ Long Text ](https://laravel-datatables.com/docs/renderer-long-text) - [ Phone Link ](https://laravel-datatables.com/docs/renderer-phone-link) - [ Progress Bar ](https://laravel-datatables.com/docs/renderer-progress-bar) - [ Status Badge ](https://laravel-datatables.com/docs/renderer-status-badge) - [ URL Link ](https://laravel-datatables.com/docs/renderer-url-link) - [ Wire Link ](https://laravel-datatables.com/docs/renderer-wire-link) ### Value Formatter - [ Compact Number ](https://laravel-datatables.com/docs/formatter-compact-number) - [ Currency ](https://laravel-datatables.com/docs/formatter-currency) - [ Duration ](https://laravel-datatables.com/docs/formatter-duration) - [ Friendly Filesize ](https://laravel-datatables.com/docs/formatter-friendly-filesize) - [ Friendly Timestamp ](https://laravel-datatables.com/docs/formatter-friendly-timestamp) - [ Locale Timestamp ](https://laravel-datatables.com/docs/formatter-locale-timestamp) - [ Number ](https://laravel-datatables.com/docs/formatter-number) - [ Percent ](https://laravel-datatables.com/docs/formatter-percent) Columns ======= Columns are the primary package customization surface. A Column controls sorting, searching, filtering, value processing, rendering, and semantic classes. 1. Standard Column Schema ------------------------- Use fluent methods for the common case. columns() PHP `use MorrowIt\LaravelDatatable\Config\Column;public function columns(): array{ return [ Column::make('id', __('ID'))->sortable()->toggleable(false), Column::make('name', __('Name'))->searchable()->sortable(), Column::make('status', __('Status'))->filterable('select', options: [ 'active' => __('Active'), 'inactive' => __('Inactive'), ]), Column::make('internal_score')->functional(), ];}` ``` use MorrowIt\LaravelDatatable\Config\Column; public function columns(): array { return [ Column::make('id', __('ID'))->sortable()->toggleable(false), Column::make('name', __('Name'))->searchable()->sortable(), Column::make('status', __('Status'))->filterable('select', options: [ 'active' => __('Active'), 'inactive' => __('Inactive'), ]), Column::make('internal_score')->functional(), ]; } ``` 2. Custom Derived Column Class ------------------------------ If you repeat the same column policy across many tables, create your own Column subclass. app/Support/Datatable/Columns/MoneyColumn.php PHP `namespace App\Support\Datatable\Columns;use MorrowIt\LaravelDatatable\Config\Column;use MorrowIt\LaravelDatatable\Formatters\Currency;class MoneyColumn extends Column{ public static function make(string $key, ?string $label = null): self { /** @var self $column */ $column = parent::make($key, $label); return $column ->sortable() ->headerClasses('ldt-align-right') ->cellClasses('ldt-align-right ldt-is-numeric') ->format(new Currency(currency: 'EUR')); }}` ``` namespace App\Support\Datatable\Columns; use MorrowIt\LaravelDatatable\Config\Column; use MorrowIt\LaravelDatatable\Formatters\Currency; class MoneyColumn extends Column { public static function make(string $key, ?string $label = null): self { /** @var self $column */ $column = parent::make($key, $label); return $column ->sortable() ->headerClasses('ldt-align-right') ->cellClasses('ldt-align-right ldt-is-numeric') ->format(new Currency(currency: 'EUR')); } } ``` Usage PHP `use App\Support\Datatable\Columns\MoneyColumn;MoneyColumn::make('total', __('Total'));` ``` use App\Support\Datatable\Columns\MoneyColumn; MoneyColumn::make('total', __('Total')); ``` Gotchas ------- When deriving Column classes, keep these constraints in mind: Column subclass gotchas TEXT `1) Keep make() return type as self so chaining remains correct.2) Do not mutate shared/static state on the class.3) Use semantic ldt-* classes (headerClasses/cellClasses), not theme-specific utility classes.4) Column::filterRenderer() can render custom controls in advanced filter modals.5) Keep translation wrapping at call sites for human labels.` ``` 1) Keep make() return type as self so chaining remains correct. 2) Do not mutate shared/static state on the class. 3) Use semantic ldt-* classes (headerClasses/cellClasses), not theme-specific utility classes. 4) Column::filterRenderer() can render custom controls in advanced filter modals. 5) Keep translation wrapping at call sites for human labels. ``` Prefer subclassing only for repeated policy. For one-off table behavior, keep customization inside columns() to reduce indirection. © 2026 Copyright (C) [ Morrow IT Consulting & Services ](https://morrow-it.services) [Terms of Service](https://laravel-datatables.com/legal/terms) [Privacy](https://laravel-datatables.com/legal/privacy) [Legal Disclosure](https://laravel-datatables.com/legal/disclosure)