# SMTP Maintenance Setup

* [General SMTP Setup](#smtpmaintenancesetup-generalsmtpsetup)
* [Test your SMTP](#smtpmaintenancesetup-testyoursmtp)
  * [Google SMTP](#smtpmaintenancesetup-googlesmtp)
  * [SendGrid SMTP](#smtpmaintenancesetup-sendgridsmtp)

***

## General SMTP Setup <a href="#smtpmaintenancesetup-generalsmtpsetup" id="smtpmaintenancesetup-generalsmtpsetup"></a>

Go to **Admin → Plugins → SMTP Maintenance**

*Click* on the <mark style="color:green;">**green**</mark>**&#x20;+** button. (See image) to add a new mail server.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FXKX0OFZKJhp5lZPG9JT8%2Fimage.png?alt=media&#x26;token=ee685c6f-3e27-481d-95b5-6a3a8dec55b3" alt=""><figcaption></figcaption></figure>

When you click on the <mark style="color:green;">**green**</mark>**&#x20;+** a dialogue box will appear. That is where you will fill out the credentials for the server and *click* **Create**.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FQc5CzWmy97jlC9Kt3UVD%2Fimage.png?alt=media&#x26;token=f66103d4-1c4a-4d94-8d16-abee589a3e83" alt="" width="371"><figcaption></figcaption></figure>

{% hint style="info" %}
**Host Name**, **Username**, **Password**, **Port Number** and **SSL settings** will all be provided by your SMTP host. Typically these values can be found with a quick Google search
{% endhint %}

## Test your SMTP <a href="#smtpmaintenancesetup-testyoursmtp" id="smtpmaintenancesetup-testyoursmtp"></a>

Now you will be able to test your **SMTP Account** right away to make sure the credentials are correct and that it is running how it should be.

To do this you will *click* on the **Envelope** Icon.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FUb1x3gPWgxI3L1bNlR6V%2Fimage.png?alt=media&#x26;token=3898ce59-9197-4564-8464-931ce89e2169" alt=""><figcaption></figcaption></figure>

Once the **envelope** is open it will display another window. There you will *enter* in your *email address*.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FfMC2vgWyZ2UHRnbAWyfK%2Fimage.png?alt=media&#x26;token=1b2cc345-0acc-46ca-a1ec-27c5a3dd7655" alt=""><figcaption></figcaption></figure>

Once you've entered your email then *click* on **‘SEND TEST’**. This is going to let you know whether it was successful or not. You will see the results by scrolling down to the bottom (see image).

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FLrOHMFlsfvHepo2vWCLz%2Fimage.png?alt=media&#x26;token=cdb6ae91-0cd9-486c-99a2-cd070e5a0260" alt=""><figcaption></figcaption></figure>

Note: *If it does **NOT** read **"SUCCESSFUL"**, chances are there is something wrong with the credentials.*

{% hint style="info" %}
**SMTP Port 25 Hosts**

Certain SMTP hosts may instruct to use port 25.  Occasionally, the SMTP connection will be unsuccessful, even with correct setup and credentials. In that event, try using port 2525 instead.
{% endhint %}

***

### Google SMTP <a href="#smtpmaintenancesetup-googlesmtp" id="smtpmaintenancesetup-googlesmtp"></a>

{% hint style="warning" %}
Google revokes your app passwords when you change your Google Account password. To continue to use an app with your Google Account, create a new app password.
{% endhint %}

#### Step 1: Enable Two-Factor Authentication (2FA)

App Passwords are only available when **2-Step Verification** is enabled on your Google account.

1. **Go to Google Account Settings**
   * Visit [myaccount.google.com](https://myaccount.google.com/).
2. **Enable 2-Step Verification**
   * Navigate to **Security** from the left-hand menu.
   * Under **"How you sign in to Google"**, click **2-Step Verification**.
   * Follow the steps to set up 2-Step Verification using your phone number or an authenticator app.

#### Step 2: Generate an App Password

1. **Access App Passwords**
   * In the **Security** section, under **"How you sign in to Google"**, look for **App Passwords**.  If not available then use the ‘Search Google Account’ search bar to find it.
   * If prompted, re-enter your Google account password.
2. **Generate a New App Password**
   * Under **"Select the app and device you want to generate the app password for"**, choose:
     * **App**: Select the app you're using (e.g., Mail).
     * **Device**: Select the device you're using or choose **Custom** to enter a name.
   * Click **Generate**.
3. **Copy the App Password**
   * A 16-character password will appear. Copy it to use in Step 3.
   * Click **Done**

#### Step 3: Use the App Password in SMTP Maintenance

Host Name: [smtp.gmail.com](http://smtp.gmail.com/)\
Username: <your-gmail-address@gmail.com>\
Password: the 16-character password from Step 2\
Port: 587\
Use SSL: Enable\
Type: STARTTLS

***

### SendGrid SMTP <a href="#smtpmaintenancesetup-sendgridsmtp" id="smtpmaintenancesetup-sendgridsmtp"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FVvekrODVc69qTmtaZV6t%2Fimage.png?alt=media&#x26;token=e692b675-5a1b-4978-b986-e67a42e5736c" alt="" width="563"><figcaption></figcaption></figure>

**Host Name:** [smtp.sendgrid.net](http://smtp.sendgrid.net)

**Username**: apikey (Not your actual API key- type in “apikey”)

**From Email**: the address associated with this SMTP Profile

**password**: API key from SendGrid
