Skip to main content
You are currently viewing the documentation for Filament 2.x, which is a previous version of Filament.Looking for the current stable version? Visit the 5.x documentation.
Notifications come fully styled out of the box. However, if you want to apply your own styling or use a custom view to render notifications, thereā€™s multiple options.

ā€‹
Styling notifications

Notifications have dedicated CSS classes you can hook into to apply your own styling:
  • filament-notifications
  • filament-notifications-notification
  • filament-notifications-icon
  • filament-notifications-title
  • filament-notifications-close-button
  • filament-notifications-date
  • filament-notifications-body
  • filament-notifications-actions

ā€‹
Custom notification view

If your desired customization canā€™t be achieved using the CSS classes above, you can create a custom view to render the notification. To configure the notification view, call the static configureUsing() method inside a service providerā€™s boot() method and specify the view to use: 
use Filament\Notifications\Notification;

Notification::configureUsing(function (Notification $notification): void {
    $notification->view('notifications.notification');
});
Next, create the view, in this example resources/views/notifications/notification.blade.php. The view should use the packageā€™s base notification component for the notification functionality and pass the available $notification variable through the notification attribute. This is the bare minimum required to create your own notification view: 
<x-notifications::notification :notification="$notification">
    {{-- Notification content --}}
</x-notifications::notification>
Getters for all notification properties will be available in the view. So, a custom notification view might look like this: 
<x-notifications::notification
    :notification="$notification"
    class="flex w-80 rounded-lg transition duration-200"
    x-transition:enter-start="opacity-0"
    x-transition:leave-end="opacity-0"
>
    <h4>
        {{ $getTitle() }}
    </h4>
    
    <p>
        {{ $getDate() }}
    </p>
    
    <p>
        {{ $getBody() }}
    </p>
    
    <span x-on:click="close">
        Close
    </span>
</x-notifications::notification>

ā€‹
Custom notification object

Maybe your notifications require additional functionality thatā€™s not defined in the packageā€™s Notification class. Then you can create your own Notification class, which extends the packageā€™s Notification class. For example, your notification design might need a size property. Your custom Notification class in app/Notifications/Notification.php might contain: 
<?php

namespace App\Notifications;

use Filament\Notifications\Notification as BaseNotification;

class Notification extends BaseNotification
{
    protected string $size = 'md';

    public function toArray(): array
    {
        return [
            ...parent::toArray(),
            'size' => $this->getSize(),
        ];
    }

    public static function fromArray(array $data): static
    {
        return parent::fromArray()->size($data['size']);
    }

    public function size(string $size): static
    {
        $this->size = $size;

        return $this;
    }

    public function getSize(): string
    {
        return $this->size;
    }
}
Next, you should bind your custom Notification class into the container inside a service providerā€™s boot() method: 
use App\Notifications\Notification;
use Filament\Notifications\Notification as BaseNotification;

$this->app->bind(BaseNotification::class, Notification::class);
You can now use your custom Notification class in the same way as you would with the default Notification object.