> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marzipan.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Email

> Manage your email sending domains and delivery settings.

The email settings page lets you register custom sending domains so that emails from your store (order confirmations, shipping notifications, marketing) are sent from your own domain rather than a shared address. This improves deliverability and builds trust with your customers.

## Sending Domains

Navigate to **Settings > Email** to manage your sending domains.

### Registering a Domain

1. Click **Add Domain** and enter your domain name (e.g. `yourbrand.com`)
2. Marzipan will display the DNS records you need to add to your domain
3. Add the records with your domain registrar or DNS provider
4. Return to the email settings page to check verification status

### Required DNS Records

You'll need to add the following DNS records:

| Record    | Purpose                                                                                            |
| --------- | -------------------------------------------------------------------------------------------------- |
| **MX**    | Routes bounce notifications and inbound replies back to Marzipan                                   |
| **SPF**   | Authorises Marzipan's mail servers to send email on behalf of your domain                          |
| **DKIM**  | Adds a digital signature to your emails, proving they haven't been tampered with                   |
| **DMARC** | Tells receiving servers how to handle mail that fails SPF or DKIM checks, improving deliverability |

<Tip>
  DNS changes can take up to 48 hours to propagate, though most updates are visible within a few hours. While records are pending, the page **auto-checks verification roughly every 60 seconds**, so you don't need to refresh manually.
</Tip>

### Verification Status

Each DNS record shows one of two states:

* **Verified** — The record has been detected and is configured correctly
* **Pending** — The record has not yet been detected. Check that it was added correctly with your DNS provider.

Once all records are verified, your domain is ready to use for sending.

<Warning>
  No emails are sent from a domain until it's verified. Add and verify your records before you rely on the domain for order confirmations or marketing.
</Warning>

## Inbound Email

Adding the **MX records** for your domain lets customer replies to your emails arrive in your Marzipan [Messages](/messages/overview) inbox, so you can respond to enquiries without leaving the app.

<Warning>
  Putting MX records on your **root domain** (e.g. `yourdomain.com`) captures **all** email for that domain, including mail sent to your normal mailboxes. To avoid this, use a dedicated subdomain such as `mail.yourdomain.com` for sending and inbound replies.
</Warning>

## Email Suppression

Marzipan automatically manages an email suppression list to protect your sender reputation. Email addresses are added to the suppression list when:

* An email bounces (the address doesn't exist or the mailbox is full)
* A recipient marks your email as spam

Suppressed addresses are automatically excluded from future sends. This happens behind the scenes — you don't need to manage the list manually.

## Delivery

Marzipan delivers your email through provider **routing rules** with automatic failover. If a provider encounters an issue, mail is routed through an alternative so your transactional emails (order confirmations, shipping updates) are delivered reliably.