PHPackages                             gtcesar/filament-expandable-table - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. gtcesar/filament-expandable-table

ActiveLibrary[Utility & Helpers](/categories/utility)

gtcesar/filament-expandable-table
=================================

Expandable master-detail rows with nested Filament tables

v1.0.0(2mo ago)517↓88.9%MITPHPPHP ^8.3CI failing

Since May 9Pushed 2mo agoCompare

[ Source](https://github.com/gtcesar/filament-expandable-table)[ Packagist](https://packagist.org/packages/gtcesar/filament-expandable-table)[ RSS](/packages/gtcesar-filament-expandable-table/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (5)Versions (2)Used By (0)

filament-expandable-table
=========================

[](#filament-expandable-table)

**Expandable master-detail rows with nested Filament tables**

[![Packagist](https://camo.githubusercontent.com/eceb35dde0c8e9e72a75fc35a05eb6f4d7a187f90cbce9144d9d32915b6b349c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f677463657361722f66696c616d656e742d657870616e6461626c652d7461626c65)](https://packagist.org/packages/gtcesar/filament-expandable-table)[![License](https://camo.githubusercontent.com/a66385f6e1fa18abe9bc077e04479a9dd0596d8cdfd4faad9f5afa84027088fe/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f677463657361722f66696c616d656e742d657870616e6461626c652d7461626c65)](LICENSE)[![PHP](https://camo.githubusercontent.com/c8d8dad6beb757a2b8acba331d16140813699543b88a37af0a81f20bd35f61de/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332532422d626c7565)](https://www.php.net)[![Filament](https://camo.githubusercontent.com/3e06f83266bad086f155b14b74d56f594bfbcca4121535f2db53ce72bf8d2aac/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d352e782d6f72616e6765)](https://filamentphp.com)

---

🇺🇸 [English](#english) | 🇧🇷 [Português](#portugu%C3%AAs)

---

🇺🇸 English
==========

[](#-english)

What does this plugin do?
-------------------------

[](#what-does-this-plugin-do)

It adds **expandable rows** to Filament 5 tables. When the user clicks the expand button on a row, a full Filament table appears directly below it — no modal, no page redirect.

```
┌─────────────────────────────────────────────────────────┐
│  # │ Customer       │ Total    │ Status   │      [+]    │
├─────────────────────────────────────────────────────────┤
│  1 │ John Smith     │ $120.00  │ Paid     │      [+]    │
├─────────────────────────────────────────────────────────┤
│    ↳ Items for Order #1                                  │
│    ┌──────────────────┬──────┬────────────────────────┐ │
│    │ Product          │ Qty  │ Unit Price             │ │
│    ├──────────────────┼──────┼────────────────────────┤ │
│    │ Blue T-Shirt (M) │  2   │ $ 30.00                │ │
│    │ Slim Jeans       │  1   │ $ 60.00                │ │
│    └──────────────────┴──────┴────────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│  2 │ Mary Johnson    │ $200.00  │ Pending  │      [+]    │
└─────────────────────────────────────────────────────────┘

```

The expand/collapse toggle is **instant** (no server round-trip). Sub-table data is loaded on demand by Livewire.

The sub-table is a full Filament table: **columns, filters, actions, bulk actions, sorting, search, and pagination** all work out of the box.

Requirements
------------

[](#requirements)

You need a Laravel project with Filament 5 already installed and working.

DependencyMin versionPHP8.3+Laravel11 or 12Filament5.xLivewire4.x (bundled with Filament 5)Installation
------------

[](#installation)

Run these two commands from your project root:

```
composer require gtcesar/filament-expandable-table
php artisan filament:assets
```

The first installs the package. The second publishes the CSS and JS assets the plugin needs for styling and animations.

> **No extra configuration needed.** Laravel auto-discovers the service provider. You do not need to touch `AppServiceProvider`, `PanelProvider`, or any config file.

Step-by-step setup
------------------

[](#step-by-step-setup)

We'll build an **Orders** table where each row expands to show its **Order Items**.

### Step 1 — Create the sub-table class

[](#step-1--create-the-sub-table-class)

Create a PHP file anywhere in your project (we suggest `app/Filament/Tables/`). This class describes the sub-table: which columns to show, which filters to apply, and how to fetch the related records.

```