# Email White Labeling Setup

### Custom Email DNS Setup

Email addresses can be white labeled to allow sending borrower notifications via a no reply email from your domain, creating a seamlessly branded experience. Both the from name and the domain can be customized on a per client basis, so for example, instead of emails coming from "Maxwell" with the email address <noreply@himaxwell.com>, it could come from your organization, such as "The Vision Mortgage Team" at <noreply@visionmortgage.com>. In order to configure this feature, you will need access to the DNS settings for the associated email domain.

Choose a specific email address and send your choice to <help@himaxwell.com>. The Maxwell support team will build out a worksheet with specific values and instructions that is customized to your organization. Below is an example of this workflow.

{% hint style="warning" %}
The workflow below is just an example, your workflow will be customized and sent to you by our support specialists.
{% endhint %}

1. Log in to the DNS provider portal for your domain (e.g. *GoDaddy*, *NameCheap*, *Google Domains*, *Digital Ocean*, etc.). If you don’t know your DNS provider login information, you may have to contact the person in your organization who maintains your web technology or helped you buy the domain.<br>

2. Add the following  `TXT` records. These records are known as SPF & DKIM. They are required for sending emails with *Mailgun*, our mail service provider.&#x20;

   <table data-header-hidden><thead><tr><th>Type</th><th width="504.3333333333333">Host</th><th>Value </th></tr></thead><tbody><tr><td>Type</td><td>Host</td><td>Value </td></tr><tr><td><code>TXT</code></td><td><code>mg.yourdomain.com</code></td><td><code>v=spf1 include:mailgun.org ~all</code></td></tr><tr><td><code>TXT</code></td><td><code>pic._domainkey.mg.yourdomain.com</code></td><td><code>k=rsa; p=yourdomain.com</code></td></tr></tbody></table>

3. Configure the following MX records for your domain. Having proper MX records shows the domain owner has invested in complete email infrastructure, not just outbound sending. MX records also indicate the domain can receive replies, suggesting it's a legitimate business communication channel. Many email providers factor in the presence of MX records when calculating sender reputation scores, and some spam filters specifically look for domains with incomplete email setups (missing MX records) as a red flag.

SPF and DKIM address different aspects of email authentication, but they don't fully establish that a domain is legitimately configured for email communication:\
SPF limitations:

* Only verifies that the sending IP is authorized to send for the domain
* Doesn't prove the domain actually receives email or is actively used for email communication
* Can be spoofed or misconfigured while still passing basic validation

DKIM limitations:

* Confirms message integrity and that it came from a domain with the private key
* Doesn't verify that the domain is actually set up to handle email as a business function
* Can exist on domains that aren't legitimate email senders

Essentially, while SPF/DKIM prove "this message is technically valid," MX records help prove "this domain is a legitimate email participant." Together, they create a more complete picture of domain trustworthiness that receiving mail servers use in their delivery decisions.

| Type | Hostname            | Priority | Value                |
| ---- | ------------------- | -------- | -------------------- |
| `MX` | `mg.yourdomain.com` | `10`     | `mxa.yourdomain.com` |
| `MX` | `mg.yourdomain.com` | `10`     | `mxb.yourdomain.com` |

4. Add a `CNAME` record for tracking. This record is necessary for tracking events such as opening emails, clicks, and unsubscribes.&#x20;

| Type    | Host                      | Value         |
| ------- | ------------------------- | ------------- |
| `CNAME` | `email.mg.yourdomain.com` | `mailgun.org` |

5. Once you set the above DNS records it can take from a few minutes to 24 hrs for those changes to propagate throughout the Internet. Please let support or your Maxwell Implementation Manager know when setup is complete on your end, and we will email you to let you know once your domain is verified.
