Skip to main content
Version: 2.1.1

Use SimpleApprovalBy

SimpleApprovalBy provides a simple way to define who is allowed to approve within an approval flow.
It follows the typical fluent Filament-style configuration.

Each ApprovalBy represents a specific approval context
(e.g. manager, employee, qa, etc.).

Create a SimpleApprovalBy​

SimpleApprovalBy::make('manager');

Approval Restrictions​

All ApprovalBy definitions are validated through Laravel's Gate system, except when using canApproveUsing().

This means:

  • If a user passes the Gate (e.g. a Superadmin),
  • they are also allowed to approve, depending on your authorization setup.

Restriction Methods​

You can define who is allowed to approve using the following methods:

Restriction by Permission​

Allow approval only if the user has a specific permission.

SimpleApprovalBy::make('manager')
    ->permission('permission_xyz');

Restriction by Role​

Allow approval only if the user has a specific role.

SimpleApprovalBy::make('manager')
    ->role('my_role');

Any​

Allow any authenticated user to approve.

SimpleApprovalBy::make('employee')
    ->any();

Custom Restriction​

Add a fully custom approval check.

⚠️ This bypasses the default Gate-based restriction logic.

SimpleApprovalBy::make('manager')
    ->canApproveUsing(
        fn ($approver, $approvable) => $approver->isAdmin()
    );

Labeling​

You can add a label to the approval context so that it automatically shows up in the ApprovalFlow so you havnt configure it for each action.

    SimpleApprovalBy::make('key')
        ->label('Manager');