Mailable classes in Laravel

Introduction

Mailable classes help you send emails easily by organizing email content and settings in one place.

When you want to send a welcome email after user registration.

When you need to send password reset instructions.

When sending order confirmation emails in an online store.

When notifying users about important updates or alerts.

When you want to customize email content with dynamic data.

Syntax

Laravel

php artisan make:mail ClassName

// Inside the Mailable class
public function build()
{
    return $this->view('emails.example')
                ->with(['key' => 'value'])
                ->subject('Email Subject');
}

Use php artisan make:mail to create a new Mailable class.

The build method defines the email content, view, and subject.

Examples

A simple Mailable class that sends a welcome email using a Blade view.

Laravel

<?php

namespace App\Mail;

use Illuminate\Mail\Mailable;

class WelcomeMail extends Mailable
{
    public function build()
    {
        return $this->view('emails.welcome')
                    ->subject('Welcome to Our Site');
    }
}

This Mailable class accepts order data and passes it to the email view.

Laravel

<?php

namespace App\Mail;

use Illuminate\Mail\Mailable;

class OrderShipped extends Mailable
{
    public $order;

    public function __construct($order)
    {
        $this->order = $order;
    }

    public function build()
    {
        return $this->view('emails.shipped')
                    ->with(['order' => $this->order])
                    ->subject('Your Order Has Shipped');
    }
}

Sample Program

This example shows a Mailable class that sends a notification email with dynamic content passed through the constructor. The email view receives the content to display.

Laravel

<?php

namespace App\Mail;

use Illuminate\Mail\Mailable;

class NotificationMail extends Mailable
{
    public $messageContent;

    public function __construct($messageContent)
    {
        $this->messageContent = $messageContent;
    }

    public function build()
    {
        return $this->view('emails.notification')
                    ->with(['content' => $this->messageContent])
                    ->subject('Important Notification');
    }
}

// Usage example in a controller or route:
use App\Mail\NotificationMail;
use Illuminate\Support\Facades\Mail;

$message = 'Hello! This is a test notification.';
Mail::to('[e-mail]')->send(new NotificationMail($message));

Important Notes

Always create a Blade view file for your email content inside resources/views/emails/.

You can chain methods like cc(), bcc(), and attach() inside build() to customize the email further.

Test emails locally using tools like Mailtrap or log driver to avoid sending real emails during development.

Summary

Mailable classes organize email logic and content in one place.

Use the build() method to set the view, subject, and data.

Pass dynamic data via the constructor to customize emails.