This comprehensive guide explores how to send emails in Laravel using Mailables and Queues. You’ll learn everything from setting up email configuration, creating mailables, attaching files, customizing templates, and handling large-scale email sending with queues. Perfect for beginners who want to master Laravel’s email system step by step.
Table of contents [Show]
Email is one of the most powerful way to communicate with users, whether it’s sending password, reset links, order confirmations, or promotional campaigns. In Laravel, sending emails is not just simple but also scalable and flexible, thanks to its robust integration with Mailables and Queues.
In this tutorial, we’ll walk you through everything you need to know about sending emails in Laravel. You’ll start with the basics, like configuring your email settings, and then move toward building reusable Mailable classes, crafting Blade-based email templates, and leveraging Laravel Queues for efficient background email sending.
Suggested Visual: A diagram showing the flow: User Action → Controller → Mailable → Mail Driver → Inbox.
Before you send any email, you need to configure Laravel’s email settings. Laravel supports multiple drivers such as SMTP, Mailgun, Postmark, SES, and more.
Open your project’s .env file and configure the following settings:
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=your_mailtrap_username
MAIL_PASSWORD=your_mailtrap_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=example@yourdomain.com
MAIL_FROM_NAME="My Laravel App"
We’re using Mailtrap for testing since it provides a sandbox environment for capturing emails during development.
Laravel provides a Mail facade to quickly send raw emails. You can test this in your routes/web.php file:
use Illuminate\Support\Facades\Mail;
Route::get('/send-test', function () {
Mail::raw('This is a test email from Laravel!', function ($message) {
$message->to('user@example.com')
->subject('Test Email');
});
return 'Test email sent!';
});
When you visit http://localhost:8000/send-test, Laravel sends the email using your configured mailer.
While Mail::raw works for quick tests, Laravel encourages using Mailables for structured and reusable email sending.
Run the following Artisan command to create a Mailable:
php artisan make:mail WelcomeMailThis generates a file in app/Mail/WelcomeMail.php.
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
class WelcomeMail extends Mailable
{
use Queueable, SerializesModels;
public $user;
public function __construct($user)
{
$this->user = $user;
}
public function build()
{
return $this->subject('Welcome to My Laravel App')
->view('emails.welcome');
}
}
We’re passing a $user object so that the email can be personalized.
Create a new Blade template at resources/views/emails/welcome.blade.php:
<!DOCTYPE html>
<html>
<head>
<title>Welcome Email</title>
</head>
<body>
<h1>Hello, {{ $user->name }}!</h1>
<p>Thank you for joining our Laravel app. We’re excited to have you!</p>
</body>
</html>You can now send the email from a controller:
use App\Mail\WelcomeMail;
use Illuminate\Support\Facades\Mail;
public function registerUser(Request $request)
{
$user = User::create($request->all());
Mail::to($user->email)->send(new WelcomeMail($user));
return "User registered and welcome email sent!";
}
You can attach files inside the build() method of your Mailable:
public function build()
{
return $this->subject('Invoice for Your Purchase')
->view('emails.invoice')
->attach(storage_path('invoices/invoice.pdf'));
}
Laravel also supports Markdown-based emails, which allow quick styling.
php artisan make:mail OrderShipped --markdown=emails.orders.shippedThis generates a Markdown template at resources/views/emails/orders/shipped.blade.php with pre-built components like buttons.
If your app sends many emails (like newsletters), sending them synchronously can slow things down. That’s where Laravel Queues shine.
Update .env to use database driver:
QUEUE_CONNECTION=databaseRun migrations for jobs:
php artisan queue:table
php artisan migrate
Mail::to($user->email)->queue(new WelcomeMail($user));
Now, instead of sending immediately, Laravel pushes the job into the queue. Run the worker with:
php artisan queue:workYou can delay sending emails by specifying a time:
Mail::to($user->email)->later(now()->addMinutes(10), new WelcomeMail($user));
If an email fails to send, Laravel stores it in the failed_jobs table.
php artisan queue:failedYou can retry failed jobs with:
php artisan queue:retry all| Method | Use Case | Performance |
|---|---|---|
| Mail::raw() | Quick test emails | Not scalable |
| Mailables | Reusable structured emails | Good for production |
| Queued Mailables | High-volume or bulk emails | Highly scalable |
Sending emails in Laravel is not only easy but also powerful when using Mailables and Queues. From simple messages to highly scalable newsletters, Laravel gives you all the tools you need to manage email workflows effectively. By mastering Mailables, Blade templates, attachments, and queues, you can build professional-grade email systems that enhance user engagement and reliability.
This article is a comprehensive tutorial on using the Prohibited Validation Rules in Laravel. You will learn how to apply prohibited, prohibited_if, and prohibited_unless with clear explanations, real-life scenarios, and code examples. This guide is perfect for developers who want to master advanced validation techniques in Laravel applications.
This detailed tutorial explores request validation in Laravel controllers. You’ll learn multiple techniques—basic controller validation, using form request classes, custom rules, conditional validation, error handling, localization, and best practices. With practical examples, code snippets, and structured explanations, this article is designed for beginners to advance learner.
This guide teaches you how to deploy Laravel applications to production servers. From preparing your environment and configuring Nginx or Apache, to database migrations, caching, performance optimization, CI/CD pipelines, and security practices—this article covers everything step by step.It’s suitable for both beginners and advanced developers who want to ship stable, secure & scalable app.
