# Mail

## Introduction

The **Mail** tab is crucial for communication between your store and your customers. Correct configuration ensures that order confirmations, account registrations, and contact form inquiries reach their destination without being marked as spam.

## Accessing Mail Settings

### Navigate to Settings

Log in to your admin dashboard and go to **System → Settings**.

#### Edit Store

Find your store in the list (usually "Your Store" by default) and click the **Edit** (blue pencil) button on the right.

#### Select Mail Tab

In the store configuration interface, click the **Mail** tab.

## Configuration Fields

![Mail Settings Interface](/files/xMmkwqzZKMXhxaOQxnrz)

### Mail Protocol

* **Mail Engine**: Choose between **Mail** (uses the built-in PHP mail function) or **SMTP** (connects to an external email server like Gmail, Outlook, or your hosting's mail server).
* **Mail Parameters**: Only used with the 'Mail' engine to add extra flags (e.g., `-f email@yourstore.com`).

### SMTP Configuration

If you select **SMTP**, you must fill in the following:

* **SMTP Hostname**: The address of your mail server (e.g., `smtp.yourdomain.com` or `ssl://smtp.gmail.com`).
* **SMTP Username**: Your full email address.
* **SMTP Password**: The password for the email account.
* **SMTP Port**: Usually `465` (SSL), `587` (TLS), or `25`.
* **SMTP Timeout**: The amount of time (in seconds) the store will wait for a response from the mail server.

### Alerts & Notifications

* **Additional Alert E-Mails**: A comma-separated list of extra email addresses that should receive notifications.
* **Alert Mail**: Check the boxes for events that should trigger an alert to the administrator:
  * **Orders**: New orders placed.
  * **Reviews**: New product reviews submitted.
  * **Affiliates**: New affiliate registrations.
  * **Customers**: New account registrations.

{% hint style="success" %}
**Recommended**: Use **SMTP** instead of 'Mail'. SMTP is more reliable, has better deliverability, and is less likely to be flagged as spam by providers like Gmail or Yahoo.
{% endhint %}

## Common Tasks

### Adding Multiple Recipients for Alerts

To notify several team members about new orders:

1. Locate the **Additional Alert E-Mails** field.
2. Enter the email addresses separated by a comma (e.g., `sales@yourstore.com,warehouse@yourstore.com`).
3. Ensure the **Orders** checkbox is checked under **Alert Mail**.

## Best Practices

<details>

<summary><strong>SMTP Deliverability</strong></summary>

**Email Authentication**

* **App Passwords**: If using Gmail or Outlook with Two-Factor Authentication (2FA), you must generate and use an "App Password" instead of your regular account password.
* **Encryption**: Always prefer `ssl://` or `tls://` prefixes for your hostname to ensure secure transmission.

</details>

<details>

<summary><strong>Managing Notifications</strong></summary>

**Avoiding Inbox Clutter**

* **Additional Emails**: Use this for secondary staff members who only need to see certain types of alerts.
* **Test Emails**: After saving your settings, perform a test by using the "Forgot Password" feature or the "Contact Us" form to verify emails are sending correctly.

</details>

{% hint style="warning" %}
**Spam Filters** ⚠️ If your emails are still landing in spam, check if your domain has correct **SPF** and **DKIM** records set up in your DNS settings. This is outside of OpenCart but essential for email health.
{% endhint %}

## Troubleshooting

<details>

<summary><strong>Emails are not being sent or received</strong></summary>

**Credential and Server Checks**

* **Check Mail Engine**: If set to 'Mail', your server might be blocking PHP mail. Switch to 'SMTP'.
* **Verify Credentials**: Ensure your SMTP username and password are correct.
* **Check Ports**: Ensure your server's firewall allows outbound connections on your SMTP port (465/587).
* **Spam Folder**: Check your spam/junk folders. If found there, configure SPF/DKIM records.

</details>

<details>

<summary><strong>SMTP Connection Timeout</strong></summary>

**Network and Configuration**

* **Hostname Prefix**: If using port 465, ensure you use `ssl://` before the hostname.
* **Timeout Setting**: Increase the **SMTP Timeout** value (e.g., from 5 to 10 or 15 seconds).
* **Firewall**: Contact your host to confirm they haven't blocked outgoing SMTP connections.

</details>

> "Reliable communication is the backbone of customer service. A properly configured mail system ensures your customers are never left in the dark about their orders."


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opencart.com/admin-interface/system/settings/mail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.