How to Send Email With Laravel Using Gmail

Laravel offers a built-in method for sending emails from your application using the Mail facade. This method requires an external mail server to connect with, such as the Gmail SMTP server, which we’ll use in this tutorial.

To start sending emails using Gmail in Laravel, you need to enable app access in your Gmail account and add your Gmail SMTP credentials to Laravel’s .env file. Afterward, you can use Laravel’s built-in Mail facade to send emails within your application.

In the following step-by-step guide, I’ll walk you through the process. Let’s dive in!

Step 1: Configure Gmail Account (Prerequisite)

Before you begin sending emails from your Laravel application, you need to configure your Gmail account to allow third-party applications to access it.

It is often suggested in tutorials to check the box “Less secure app access” which used to work. However, this option has been removed from Gmail.

To enable Laravel access you must enable 2-Step Verification on your Google account page:

Screenshot Showing Google Account Security Settings

If it says “2-Step Verification is off” you need to walk through the steps to provide your phone number. This adds security to your account by enabling sending a code by SMS for all your sign-ins.

After you’ve enabled 2-step Verification it shows a green check and you can click it again to configure app access:

Screenshot Showing Activated Google Account 2-Step Verification

After clicking “2-Step Verification” scroll down to the bottom part for App passwords. Add one as shown in the animation below and copy and paste it into your .env file later on in Step 3.

GIF Animation Showing How to Generate an App Password for Your Google Account

Step 2: Install Laravel

If you haven’t already set up a Laravel project, create one using Composer:

composer create-project laravel/laravel EmailDemo

Step 3: Configure Mail Settings in .env

Open the .env file in your Laravel project root and set up the mail configuration:

MAIL_FROM_NAME="laracoding.test EmailDemo"

Replace with your own Gmail address and your_app_password with the password you’ve generated in Step 1.

Step 4: Create a Mail Class

Laravel Artisan can automatically create a dedicated class for your email by running:

php artisan make:mail WelcomeMail

Open the WelcomeMail.php file generated in the app/Mail directory. Customize the __construct to support passing in a $title and a $body. Also, customize the functions envelope() and content() to define the email’s content and subject. Alternatively can copy & paste the following code to achieve this:


namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Content;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;

class WelcomeMail extends Mailable
    use Queueable, SerializesModels;

     * Create a new message instance.
    public function __construct(private string $title, private string  $body)

     * Get the message envelope.
    public function envelope(): Envelope
        return new Envelope(
            subject: 'Welcome to EmailDemo',

     * Get the message content definition.
    public function content(): Content
        return new Content(
            view: 'emails.welcome',
            with: [
                'title' => $this->title,
                'body' => $this->body,

     * Get the attachments for the message.
     * @return array<int, \Illuminate\Mail\Mailables\Attachment>
    public function attachments(): array
        return [];

Step 5: Create a Controller

Next, let’s create a controller that will handle sending the welcome email. Use this artisan command to generate a controller:

php artisan make:controller EmailController

Open the EmailController.php file in the app/Http/Controllers directory and add the following code:


namespace App\Http\Controllers;

use App\Mail\WelcomeMail;
use Illuminate\Support\Facades\Mail;

class EmailController extends Controller
    public function sendWelcomeEmail()
        $title = 'Welcome to the example email';
        $body = 'Thank you for participating!';

        Mail::to('')->send(new WelcomeMail($title, $body));

        return "Email sent successfully!";

Note: in the code above replace “” with your email address on which you’ll receive the test email.

Step 6: Create a Route

In the routes/web.php file, add a route that maps to the sendWelcomeEmail method:

use App\Http\Controllers\EmailController;

Route::get('/send-welcome-email', [EmailController::class, 'sendWelcomeEmail']);

Step 7: Create an Email Template Using Blade

Create an email template using Blade. In the resources/views/emails directory, create a welcome.blade.php file and customize the email’s content using HTML and Blade syntax. Here’s a simple example:

<!DOCTYPE html>
    <title>{{ $title }}</title>
    <p>{{ $body }}</p>

Step 8: Run the Example to Send Email

You’re all set to send the welcome email! Start your Laravel application:

php artisan serve

Open your web browser and visit:


The sendWelcomeEmail method will send the welcome email with the predefined title and body. Check your recipient email inbox to see the result.


Sending emails using Gmail and Laravel is a straightforward process thanks to Laravel’s built-in Mail facade.

By following the steps in this tutorial, you can easily configure your Gmail account, create a mail class add a template, and send emails with just a few lines of code.

Feel free to use this in your own application. Happy coding!


Johan van den Broek

Johan is the creator of As a child, he began tinkering with various programming languages, many of which have been long forgotten today. Currently, he works exclusively with PHP and Laravel, and his passion for programming remains to this day.

15 thoughts on “How to Send Email With Laravel Using Gmail

  1. Hello Mr Johan , first thanks for this great article because a lot of article are showing only the old way of integrating gmail with the option of less secure apps.
    Your article is awesome , however your might rectify something : ” in the .env, the EMAIL_PASSWORD must be the one Gmail provide to you while you are creating an APP PASSWORD it is not you_gmail_password”

    1. I’m glad you’ve found the post helpful. I’ve edited the part you’ve mentioned to clarify that the app password created in Step 1 should be used. Thanks a bunch for pointing it out!

      1. google will disable send email using password and we should use google api, do you have a solution for that?


        1. Using normal email password from a “less secure app” was removed but creating a specific app password works. Removal of this isn’t announced anywhere.

  2. Hello Johan, thank you very much for this article, The view path should be: ‘mails.welcome’ with an s

    1. You’re welcome and thanks for letting me know about that mistake. I’ve fixed the blog posts example code accordingly.

  3. Hello Johan, thank you for this article, I followed this article on my laptop but I didn’t success.

    Symfony \ Component \ ErrorHandler \ Error \ FatalError
    PHP 8.2.12
    Maximum execution time of 60 seconds exceeded

    I got this error every time. Could you please let me know the why?

    1. A few things you can do.
      1. Check the log at storage/logs/laravel.log for a trace that shows where it spent all that time. See if it can be fixed.
      2. Increase max_execution_time in php.ini

    1. You’re welcome, I’m glad this tutorial helped you. There sure are a lot of outdated guides around on the internet.

  4. Hallo Johan, I’ve tried your tutorial but I got an error “Expected response code 220 but got an empty response”

    1. I’d try and troubleshoot it using the logs in storage/laravel.log

  5. I got this error
    Connection could not be established with host “mailpit:1025”: stream_socket_client(): php_network_getaddresses: getaddrinfo for mailpit failed: Name or service not known

    1. My guess is you have MAIL_HOST still set to ‘mailpit’. Review and edit your .env to fix this (see step 3).

Leave a Reply

Your email address will not be published. Required fields are marked *

Recent Posts