Configuration

php artisan vendor:publish --tag="audit-trails-config"

Published file: config/audit-trails.php.

model

Override the audit trail model class. Useful when you need to attach extra traits — for example multi-tenant scoping — without forking the package.

'model' => \App\Models\AuditTrail::class,

namespace App\Models;

use Aaix\LaravelAuditTrails\Models\AuditTrail as BaseAuditTrail;
use App\Concerns\BelongsToTenant;

class AuditTrail extends BaseAuditTrail
{
    use BelongsToTenant;
}

Your subclass must extend the package model so all relations and casts continue to work.

table

Rename the table:

'table' => 'app_audit_log',

The model resolves the table from this value, and the published migration uses it too.

user_resolver

Returns the user identifier (or null) attached to each audit row. Default:

'user_resolver' => static fn (): mixed => auth()->id(),

Override when you need a system actor for queue/console writes:

'user_resolver' => static function (): ?int {
    if ($user = auth()->user()) {
        return $user->id;
    }

    return app()->runningInConsole() ? config('audit-trails.system_user_id') : null;
},

The resolver is invoked at write time, so it sees the current request context.

ignored_attributes

Globally strip attributes from updated change sets. Defaults:

'ignored_attributes' => [
    'updated_at',
    'deleted_at',
    'password',
    'remember_token',
],

Updates that consist only of ignored attributes are skipped entirely — no row is written.

For per-model overrides, see Usage → Per-model ignored attributes.