Cell Renderer - Datatables for Laravel                  [               Datatables for Laravel  ](/) [ 1.0.5](https://laravel-datatables.com/release-notes "Click to view release notes")

  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.

    Docs     

### Getting Started

- [ Installation ](https://laravel-datatables.com/docs/start-installation)
- [ Manual Installation ](https://laravel-datatables.com/docs/start-manual-installation)
- [ Dark Mode ](https://laravel-datatables.com/docs/start-dark-mode)

### Basics

- [ Creating a Table ](https://laravel-datatables.com/docs/basic-creating-a-table)
- [ Displaying Columns ](https://laravel-datatables.com/docs/basic-displaying-columns)
- [ Data Sources ](https://laravel-datatables.com/docs/basic-data-sources)
- [ Internationalisation ](https://laravel-datatables.com/docs/basic-internationalisation)
- [ Styling ](https://laravel-datatables.com/docs/basic-styling)

### Features

- [ Accessibility ](https://laravel-datatables.com/docs/feature-accessibility)
- [ Aggregate Columns ](https://laravel-datatables.com/docs/feature-aggregate-columns)
- [ Bulk Actions ](https://laravel-datatables.com/docs/feature-bulk-actions)
- [ Column Reordering ](https://laravel-datatables.com/docs/feature-column-reordering)
- [ Column Visibility ](https://laravel-datatables.com/docs/feature-column-visibility)
- [ Custom Controls ](https://laravel-datatables.com/docs/feature-custom-controls)
- [ Custom Filters ](https://laravel-datatables.com/docs/feature-custom-filters)
- [ Exporting ](https://laravel-datatables.com/docs/feature-exporting)
- [ Freeze Columns and Headers ](https://laravel-datatables.com/docs/feature-freeze-columns-and-headers)
- [ Inline Editing ](https://laravel-datatables.com/docs/feature-inline-editing)
- [ Pagination ](https://laravel-datatables.com/docs/feature-pagination)
- [ Responsive Mobile ](https://laravel-datatables.com/docs/feature-responsive-mobile)
- [ Row Actions ](https://laravel-datatables.com/docs/feature-row-actions)
- [ 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/feature-sorting-and-searching)
- [ State Persistence ](https://laravel-datatables.com/docs/feature-state-persistence)
- [ Value Preparation ](https://laravel-datatables.com/docs/feature-value-preparation)

### Customization

- [ Cell Renderer ](https://laravel-datatables.com/docs/customization-cell-renderer)
- [ Columns ](https://laravel-datatables.com/docs/customization-columns)
- [ Components ](https://laravel-datatables.com/docs/customization-components)
- [ Data Sources ](https://laravel-datatables.com/docs/customization-data-sources)
- [ Exporting ](https://laravel-datatables.com/docs/customization-exporting)
- [ Filters ](https://laravel-datatables.com/docs/customization-filters)
- [ Loading Indicator ](https://laravel-datatables.com/docs/customization-loading-indicator)
- [ Multi Row Actions ](https://laravel-datatables.com/docs/customization-multi-row-actions)
- [ Pagination ](https://laravel-datatables.com/docs/customization-pagination)
- [ Row Actions ](https://laravel-datatables.com/docs/customization-row-actions)
- [ Sorting Icons ](https://laravel-datatables.com/docs/customization-sorting-icons)
- [ State Persistence ](https://laravel-datatables.com/docs/customization-state-persistence)
- [ Value Formatter ](https://laravel-datatables.com/docs/customization-value-formatter)

### 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)

Cell Renderer
=============

Renderers produce final cell output (typically HTML). Use them when formatted text alone is not enough.

Renderer \_\_invoke Parameters
------------------------------

Every renderer implements \_\_invoke($value, $row).

Parameter meaning

TEXT

     `$value: current column value after prepare/format stages.$row: full row payload (array/object), useful for IDs or related values.` 

```
$value: current column value after prepare/format stages.
$row: full row payload (array/object), useful for IDs or related values.
```

Use a renderer when you need HTML output, links, icons, badges, buttons, or conditional markup. For plain text transformations, prefer a formatter to keep rendering simpler.

Implement RendererInterface
---------------------------

Create project renderers outside vendor so package upgrades remain clean.

app/Support/Datatable/Renderers/StatusPill.php

PHP

     `namespace App\Support\Datatable\Renderers;use MorrowIt\LaravelDatatable\Contracts\RendererInterface;class StatusPill implements RendererInterface{    public function __invoke($value, $row)    {        $text = (string) $value;        $id = data_get($row, 'id');        return '' . e($text) . '';    }}` 

```
namespace App\Support\Datatable\Renderers;

use MorrowIt\LaravelDatatable\Contracts\RendererInterface;

class StatusPill implements RendererInterface
{
    public function __invoke($value, $row)
    {
        $text = (string) $value;
        $id = data_get($row, 'id');

        return '' . e($text) . '';
    }
}
```

Always escape user-controlled values (for example with e()) before returning HTML to avoid XSS vulnerabilities.

Attach Renderer to a Column
---------------------------

Use Column::renderer() with package or custom renderers.

columns()

PHP

     `Column::make('status', __('Status'))    ->renderer(new \App\Support\Datatable\Renderers\StatusPill());Column::make('actions', __('Actions'))    ->renderer(new \MorrowIt\LaravelDatatable\Renderers\ActionButtons());` 

```
Column::make('status', __('Status'))
    ->renderer(new \App\Support\Datatable\Renderers\StatusPill());

Column::make('actions', __('Actions'))
    ->renderer(new \MorrowIt\LaravelDatatable\Renderers\ActionButtons());
```

Anonymous Renderers
-------------------

Of course you don't have to create a custom renderer class for every trivial modification, simply use an anonymous function that has the same signature as RendererInterface::\_\_invoke(\\$value, \\$row). This is useful for small tweaks or one-off renderers.

Anonymous renderer

PHP

     `Column::make('status', __('Status'))    ->renderer(function($value, $row) {        return '' . e((string) $value) . '';    });` 

```
Column::make('status', __('Status'))
    ->renderer(function($value, $row) {
        return '' . e((string) $value) . '';
    });
```

See Cell Renderer section to see what built-in renderers are available.

For practical combinations, compare with formatter examples in Value Formatter and pair them when needed (for example FriendlyTimestamp formatter + renderer).

   © 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)