Action Overflow

• Why use it
• Compatibility
• Installation
• Quick start
• Customizing the More button
• Dividers (sections inside the More menu)
• Hidden, invisible, unauthorized
• Reference
  • Config keys (config/action-overflow.php)
  • Fluent API
• Testing
• Changelog
• Credits
• License

Turn any Filament action list into a few primary buttons + a "More" dropdown, automatically.

[ Edit ] [ Archive ] [ ⋮ More ▾ ]
                       ├─ Publish
                       ├─ Delete
                       └─ Download

You write a flat list of actions; the package decides which sit out front and which get tucked under More. Works anywhere Filament accepts an action array — page headers, table actions, record actions, bulk actions, widgets.

#Why use it

• One line. Append ->withOverflow() to an ActionGroup and you're done.
• Smart defaults. No overflow → no More. One overflow action → flattened. Two or more → grouped.
• Divider aware. Filament 5's ->dropdown(false) divider sections pass through into the More menu cleanly.
• Hidden-action aware. ->hidden() / ->visible(false) / (optionally) ->authorize(...) are honored before composing.

#Compatibility

#Installation

composer require harvirsidhu/filament-action-overflow

The package works without any config. Publish only if you want to change defaults:

php artisan vendor:publish --tag="filament-action-overflow-config"

#Quick start

The macro is the simplest path. Build an ActionGroup like normal, append ->withOverflow($primary), and return the result.

use Filament\Actions\Action;
use Filament\Actions\ActionGroup;

public function getHeaderActions(): array
{
    return ActionGroup::make([
        Action::make('edit'),
        Action::make('archive'),
        Action::make('delete'),
    ])->withOverflow(1);
    // → [ Edit ] [ ⋮ More ▾ (Archive, Delete) ]
}

->withOverflow() is terminal — it returns the composed array<Action | ActionGroup> ready for getHeaderActions(), getTableActions(), getRecordActions(), etc.

By default both the primary actions and the More trigger are promoted to button view, so you get a row of matching buttons without sprinkling ->button() on each action.

#Customizing the More button

For control over the dropdown's label, icon, color, etc., use the ActionOverflow facade:

use Filament\Actions\Action;
use Harvirsidhu\FilamentActionOverflow\Facades\ActionOverflow;

return ActionOverflow::make([
    Action::make('edit'),
    Action::make('archive'),
    Action::make('delete'),
])
    ->primaryCount(2)
    ->label('Options')
    ->icon('heroicon-m-bars-3')
    ->color('gray')
    ->toActions();

#Dividers (sections inside the More menu)

A dropdown(false) group nested inside another ActionGroup is Filament's way of saying "render these as a separated section." This package treats them as first-class:

use Filament\Actions\Action;
use Filament\Actions\ActionGroup;

return ActionGroup::make([
    Action::make('submit'),

    ActionGroup::make([
        Action::make('discount'),
        Action::make('tax'),
        Action::make('rounding'),
    ])->dropdown(false),

    ActionGroup::make([
        Action::make('change-billing'),
        Action::make('refresh'),
    ])->dropdown(false),
])->withOverflow(1);

Renders as:

[ Submit ] [ ⋮ More ▾ ]
              ├─ ──────────
              ├─ Discount
              ├─ Tax
              ├─ Rounding
              ├─ ──────────
              ├─ Change billing
              └─ Refresh

How dividers behave in the composer:

• A divider doesn't take up a primary slot — its children do. With primaryCount: 2 and a divider whose first child is submit, submit is promoted to primary.
• Dividers never appear among side-by-side primary buttons (they only make sense inside a dropdown).
• A divider at the very top of the More menu is unwrapped (no orphan line above the first item).
• Trailing and adjacent dividers stay as distinct sections — exactly how Filament renders them natively.
• Hidden / invisible children are dropped from dividers; if every child is dropped, the divider disappears.

#Hidden, invisible, unauthorized

Hidden and invisible actions are filtered automatically:

return ActionOverflow::make([
    Action::make('edit')->hidden(),         // dropped
    Action::make('archive'),                // kept
    Action::make('delete')->visible(false), // dropped
    Action::make('publish'),                // kept
])->toActions();

Authorization filtering is opt-in because Filament's renderer already disables unauthorized actions visually:

return ActionOverflow::make($actions)
    ->filterUnauthorized()
    ->toActions();

#Reference

#Config keys (config/action-overflow.php)

icon accepts a string, a BackedEnum (e.g. Filament\Support\Icons\Heroicon::EllipsisVertical on Filament 5), or null for the default. icon_position accepts the string forms or a Filament\Support\Enums\IconPosition enum. Strings are the published defaults so the file loads cleanly on both Filament 4 and 5.

#Fluent API

ActionOverflow::make($actions)
    ->primaryCount(int $count = 1)
    ->label(string $label = 'More')
    ->icon(string|\BackedEnum|null $icon = null)
    ->color(string $color = 'gray')
    ->hiddenLabel(bool $state = true)
    ->button(bool $state = true)
    ->iconPosition(\Filament\Support\Enums\IconPosition|string|\BackedEnum|null $position = \Filament\Support\Enums\IconPosition::After)
    ->filterUnauthorized(bool $state = true)
    ->toActions();

->button(false) is opt-out only — it stops the composer from calling ->button(). If a caller already passed a pre-buttoned action, it keeps its button view.

#Testing

composer test

#Changelog

See CHANGELOG.

#Credits

• harvirsidhu

#License

MIT — see LICENSE.