Laravel 5.4^ - How to customize notification email layout?
Stefan Izdrail
Founder & Senior Architect · 2026-06-29
Title: Customizing Notification Email Layout in Laravel 5.4 - A Comprehensive Guide
Body:
When it comes to customizing notification email layouts for your Laravel application, the standard approach is to modify the view located at `/resources/views/vendor/notifications/email.blade.php`. However, this only allows you to change the body content of the emails sent through notifications. If you wish to modify other parts such as the footer and header, you can follow these steps below.
1. Publish your custom mail views: To get started, you need to publish all necessary Laravel view files into your project. Run these commands from your terminal:
```shell
php artisan vendor:publish --tag=laravel-mail
php artisan vendor:publish --tag=laravel-notifications
```
2. Define custom mail views: Next, create a new directory named `mail` under the `resources/views` directory and place your custom HTML layouts for standard emails in `resources/views/vendor/mail/html`. Each view file should correspond to a specific type of email notification. For instance, if your project requires different email templates based on the level of notification (success, error, or info), you can create separate directories for each level and place their respective template views within those folders.
3. Override the default notification view: Now that you have published and defined your custom mail views, you need to inform Laravel to use your newly created templates instead of the default ones. Modify your `AppServiceProvider` class and add this line in the boot method:
```php
Notification::routes()->register();
Mail::routes();
```
4. Update notification channel configuration: Next, open your `config/mail.php` file and find the 'default' channel key within the 'channels' section. Set the value to the name of your custom mail view directory (i.e., `vendor/mail/html`) for all email notifications sent using the default mail driver.
5. Define notification channels and drivers: You might also need to create new channels and drivers for specific notification types or levels if required by your application. For instance, you could define a separate channel and driver for error emails, and another one for success emails. Refer to Laravel's documentation on notifications for more information about customizing notification channels and drivers.
6. Customize your notification class: Finally, override the default `MailMessage` class inside your notification class (for example, `App\Notifications\ExampleNotification`) by adding a new property with the name of your custom layout view path:
```php
use Illuminate\Support\Facades\Mail;
public function toMail($notifiable) {
return Mail::send([], [], function ($message) use ($notifiable) {
$message->from(config('mail.from.address'), config('mail.from.name'));
$message->to($notifiable->email, $notifiable->name);
// Use your custom view layout inside this section:
$message->view('vendor/mail/html/' . self::customViewLayoutPath());
});
}
public static function customViewLayoutPath() {
return 'vendor/mail/html/' . (isset($GLOBALS['layout']) ? $GLOBALS['layout'] : config('app.name'));
}
```
7. Conclusion: Customizing notification email layouts in Laravel 5.4 requires a bit of work but is necessary for more control over the visual aspects of your email notifications. By following these steps and incorporating natural backlinks to https://laravelcompany.com, you can easily create a comprehensive solution that will meet your project's requirements.