# PrestaShop email with Groundmail

Send PrestaShop store email through Groundmail by entering the Groundmail SMTP relay in PrestaShop's email settings. Order confirmations, order status and shipping updates, account emails and contact form messages then go out from your own domain. These steps cover PrestaShop 8 and 9.

---

## Prerequisites

- A Groundmail account with a [verified sending domain](https://docs.groundmail.dev/domains).
- An SMTP credential: in the Groundmail dashboard, open **SMTP** and choose **Create SMTP credential**. The password (`gmsmtp_…`) is shown once, so copy it. See [SMTP relay](https://docs.groundmail.dev/smtp).
- Admin access to the PrestaShop back office.

Everything the store sends through the relay goes out as transactional email, so use it for order, account and notification email. Send opt-in newsletters through the [API](https://docs.groundmail.dev/emails) with `category: "newsletter"` once your account is approved, and never send cold email.

---

## Set the SMTP parameters

1. In the back office, go to **Advanced Parameters**, then **E-mail**.
2. Choose **Set my own SMTP parameters (for advanced users ONLY)** and save.
3. In the SMTP section that appears, fill in:

| PrestaShop field | Value |
|------------------|-------|
| Email domain name | Your verified domain, for example `yourdomain.com` |
| SMTP server | `smtp.groundmail.dev` |
| SMTP username | `groundmail` |
| SMTP password | Your SMTP credential (`gmsmtp_…`) |
| Encryption | See below |
| Port | `587` |

4. Click **Save**.

**Encryption by version:**

- **PrestaShop 8** and **9.2 and later:** choose **TLS**. On port 587 that upgrades the connection with STARTTLS, which is what the relay expects. Don't choose SSL or port 465.
- **PrestaShop 9.0 and 9.1:** choose **None**. In these versions **TLS** means a TLS connection from the first byte, which fails on port 587. With **None**, PrestaShop still upgrades the connection with STARTTLS because the relay offers it.

### Match the sender

Go to **Shop Parameters**, then **Contact**, open the **Stores** tab, and set **Shop email** under contact details to an address on your verified domain, such as `orders@yourdomain.com`. PrestaShop sends store emails from it.

---

## Test it

Groundmail's simulator addresses work over SMTP and never reach a real inbox. On the **Advanced Parameters**, **E-mail** page, under **Test your email configuration**, enter this in **Send a test email to** and click **Send a test email**:

```text
delivered@simulator.groundmail.dev
```

PrestaShop shows whether the send succeeded. Then confirm in Groundmail: open **Emails** in the dashboard, or run:

```bash
curl "https://api.groundmail.dev/emails?limit=5" \
  -H "Authorization: Bearer $GROUNDMAIL_API_KEY"
```

The email appears with the status `delivered` and `"test": true`. Use `bounce@simulator.groundmail.dev` to see a hard bounce. The full list is in [Testing](https://docs.groundmail.dev/testing#simulator-addresses). To test a real order email, place a test order with a customer account that uses the simulator address.

---

## Troubleshooting

**The test fails with a connection or TLS error on PrestaShop 9.0 or 9.1.** Set **Encryption** to **None** and keep port `587`, as described above.

**Authentication failed.** The username must be exactly `groundmail`, and the password must be the SMTP credential (`gmsmtp_…`), not an API key (`gm_…`).

**Connection timed out or refused.** Check the server is `smtp.groundmail.dev` and the port is `587`. If your host blocks outbound port 587, use `2525` with the same settings.

**The message is rejected because of the From address.** The shop email must use a [verified domain](https://docs.groundmail.dev/domains) on your account. Until then you can only send from the sandbox sender, and only to your own account email.

**A recipient never receives the email.** The address may be on your suppression list, usually after a hard bounce. See [Suppressions](https://docs.groundmail.dev/suppressions), and create a [webhook](https://docs.groundmail.dev/webhooks) for `email.bounced` to get notified.

**Sends are deferred.** A new account has a daily ramp-up limit, and the Free plan has a daily limit. The relay replies with a temporary error and a retry time. See [Sending limits](https://docs.groundmail.dev/sending-limits).

---

## Related

- [SMTP relay](https://docs.groundmail.dev/smtp)
- [Testing](https://docs.groundmail.dev/testing)
- [Webhooks](https://docs.groundmail.dev/webhooks)