# Setting up a Sending Domain

Sending emails from your store domain signature helps to increase email deliverability, and when your store domain is set up, the emails that are sent to customers will appear as if they are coming from your store domain signature, rather than from the Retainful domain.

Watch a step-by-step video tutorial for setting your email sending domain

{% embed url="<https://youtu.be/bq6CKhvspMQ?si=PA7DuzcnUJTBgDZM>" %}

### **What is a Sending Domain?**

When sending emails, domains are a crucial part of how people recognize and experience your brand. For example, if your company is acme.com, you would be wise to include the domain name ‘acme.com’ in the domain name that you send your emails from instead of a shared domain.

If you have not configured the Sending Domain at your [Retainful dashboard](https://app.retainful.com/dashboard) -> Settings -> Email -> Sending Domain, all the emails that are being sent from Retainful, will appear as they are signed/sent from Retainful’s shared domain.

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FYBxk8W6W6WjFilA0EHT1%2Fdefault-sending-domain.png?alt=media&#x26;token=63442301-a1bf-409f-8808-ac6aa7807305" alt="Sending Emails From Retainful&#x27;s Domain"><figcaption><p>Sending Emails From Retainful's Domain</p></figcaption></figure>

Setting up your email domain in Retainful ensures that all emails are delivered from your domain, which removes the "via retainful.net" from the emails and uses "yourdomain.com" on the email properties.

And, your sender email address (from email address) will match the domain you’re sending from. This means that your emails will no longer appear to be sent by a shared domain.

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FjziTGWAzXVdLiw2PXe8L%2Fsending_email_from_shop_domain.png?alt=media&#x26;token=ab1eabab-fec9-488d-a801-aa75ce804a96" alt="Sending Email From Your Own Domain"><figcaption><p>Sending Email From Your Own Domain</p></figcaption></figure>

{% hint style="warning" %}
NOTE: You can configure the ‘From Name’, ‘From Email Address’, ‘Reply To Address’ at your [Retainful dashboard](https://app.retainful.com/dashboard) -> Settings -> Email -> Email Properties.
{% endhint %}

### **Why should you use your domain to send emails?**

Customers expect your business to have a domain name and a website.

Free email services, such as Gmail and Yahoo, are great for personal use, but when you use a free email account for business purposes, people will start to doubt your professionalism and credibility.

Sending emails from your own domain also has the added benefit of preventing your store's emails from being marked as spam by an email authentication measure called \*DMARC \*(Domain-based Message Authentication, Reporting & Conformance).

### Setting up your Email Sending Domain

In this section of the article, we will see how to set up your email sending domain in Retainful.

**Checklist**&#x20;

1. Generating DNS records&#x20;
2. Adding the DNS records to the Domain host&#x20;
3. Verifying the DNS records

**Generating DNS records**

1. Log in to your [Retainful dashboard](https://app.retainful.com/dashboard)
2. Go to Settings -> Email -> Sending Domain
3. Enter your ‘Subdomain Name’ and click on ‘Add Domain’

{% hint style="info" %}
We allow adding "subdomains" as sending domains. Since many store owners configure a number of SPF records for the main domain, it causes confusion and misconfiguration. So, we changed the "Sending domain" to use the subdomain... You can enter something like "send" as the subdomain and add the DNS records.
{% endhint %}

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2F8CdQpvCJ9B0aF5EFa3ZT%2Fsending-domain-new.png?alt=media&#x26;token=c6e4e96c-379a-40f5-ad26-42ea3c4e3f44" alt="Enter the subdomain name"><figcaption><p>Enter the subdomain name</p></figcaption></figure>

4\. Once you click on Add Domain, a success message appears with the DNS records like this,

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2Fg2jNE3aqougaTKFtCux3%2FDNS-records.jpg?alt=media&#x26;token=53bc029b-ee02-420c-80c1-b7f36442bd0c" alt="DNS Records"><figcaption><p>DNS Records</p></figcaption></figure>

5\. You can find three DNS records in the list, the first two are ‘TXT’ type, and the last one is in ‘CNAME’ type. These records have to be added to the hosting account's DNS records page.

**Adding the DNS records to the Domain host**\
You can follow the below instructions to add/edit the DNS records to the domain host.

{% hint style="info" %}
NOTE: Below is general instructions for adding/editing DNS records that will work for most domain hosts. We would be coming up with more detailed documentation on how to add those records on specific hosts.
{% endhint %}

I) Login to your hosting provider account; For instance,

* [**GoDaddy**](https://www.godaddy.com/help/manage-dns-zone-files-680)
* [**Hostgator**](https://www.hostgator.com/help/article/manage-dns-records-with-hostgatorenom)
* [**AWS**](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-editing.html)
* [**Google Domains**](https://support.google.com/a/answer/48090?hl=en)
* [**Bluehost**](https://www.bluehost.in/hosting/help/dns-management-add-edit-or-delete-dns-entries)
* [**Hostinger**](https://support.hostinger.com/en/articles/1583249-how-to-manage-my-dns-records-at-hostinger)

II) Go to your domain's DNS records page, often called ‘DNS Management’, ‘Name Server Management’

III) Select the option to add a new record.

IV) Adding the ‘TXT’ type records,

1. Select record type ‘TXT’
2. In the Host/Alias/Name field, paste the Host/Name entry copied from the Retainful settings page. The name entry to be copied is indicated in the below screenshot:

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FruRgCvNmEQcAD3t3bIF6%2Fcname-record-host-name.jpg?alt=media&#x26;token=01c73cdc-59f3-4b57-9a44-c4f43aa86653" alt="Copy the host name"><figcaption><p>Copy the host name</p></figcaption></figure>

&#x20; 3\. In the Value/Answer/Destination field, paste the Value/Alias To copied from Retainful settings page. The value to be copied is indicated in red in the below screenshot:&#x20;

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FCnG540b7HnQqFORItYUX%2Ftxt-record-value.jpg?alt=media&#x26;token=53e7a1dc-43b8-4138-846a-d60e9d8da0c3" alt="Copy the value"><figcaption><p>Copy the value</p></figcaption></figure>

&#x20;  4\. Save the record.

&#x20;  5\. You can add the second TXT record, by repeating the same process (Step 1 to Step 4)

V) Adding the CNAME record,\
&#x20;   1\. Select the option to add a new record

&#x20;   2\. Select record type ‘CNAME’

&#x20;   3\. In the Host/Alias/Name field, paste the Host/Name entry copied from the Retainful settings page. The name entry to be copied is indicated in the below screenshot:

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2F9rMIDk747zvrj6IRAnKO%2Fcname-record-host-name.jpg?alt=media&#x26;token=94a6dfd5-c524-4b17-83da-1f1574e08b90" alt="Copy host name"><figcaption><p>Copy host name</p></figcaption></figure>

&#x20;  4\. In the Value/Answer/Destination field, paste the Value/Alias To copied from Retainful settings page and save the record. The value to be copied is indicated in red in the below screenshot:

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FgWRqZ5lninTG7Q53Ufvj%2Fcname-record-value.jpg?alt=media&#x26;token=014f92f3-727c-4716-bf91-83df2b7dce30" alt="Copy the value"><figcaption><p>Copy the value</p></figcaption></figure>

&#x20;   5\. Save the record

That’s it. You have added the DNS records to your domain host.

**Verifying the DNS records**

After adding the DNS records to your domain host, you need to verify if the records are added properly.

To verify the DNS records, visit your [Retainful dashboard](https://app.retainful.com/dashboard) -> Settings -> Email -> Sending Domain and click on the ‘Verify Domain’ button.

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FLS10nmsnsZaW3S62fGcG%2Fverifying-dns-records.jpg?alt=media&#x26;token=39cdf2a3-7fe8-4d30-833e-7f7ec5871f47" alt="Verify the domain"><figcaption><p>Verify the domain</p></figcaption></figure>

{% hint style="warning" %}
Note: DNS can take up to 48 hours max to update. You might want to wait some time before clicking on the ‘Verify Domain’ button on the Retainful dashboard -> Settings -> Email -> Sending Domain.
{% endhint %}

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2FeYSiMsj8f2EcFkDRdCCT%2Fdns-verification-success-message.jpg?alt=media&#x26;token=ba590f49-127f-4431-8881-876cf0950028" alt="Domain Verified"><figcaption><p>Domain Verified</p></figcaption></figure>

Once the DNS records are verified, the emails will go with your domain signature (DKIM) and will appear to come from your brand.

### Known Issues

The following are some of the known issues when adding DNS records

1. **Host Names handling differs for some DNS providers**

Some hosting service providers like GoDaddy will ask you to enter only Names without the "Root domain"

For instance, when you try to add the following TXT record:

<table><thead><tr><th width="186">Name</th><th width="94">Type</th><th>Value</th></tr></thead><tbody><tr><td>send.example.com</td><td>TXT</td><td><code>v=spf1 include:spf.retainful.net ~all</code></td></tr></tbody></table>

The Name value contains two parts:

1. send  =  this is the subdomain
2. example.com = this is the root domain

GoDaddy will automatically show the root domain. In the above table, "example.com" is the root domain. "send" is the subdomain.

In GoDaddy, you should only enter the "Subdomain" value alone. Like this:

<table><thead><tr><th width="186">Name</th><th width="94">Type</th><th>Value</th></tr></thead><tbody><tr><td>send</td><td>TXT</td><td><code>v=spf1 include:spf.retainful.net ~all</code></td></tr></tbody></table>

{% hint style="warning" %}
DO NOT enter the root domain if it already appended by your DNS Provider. If you do, then the "Name" value will become like: `send.example.com.example.com`&#x20;
{% endhint %}

The above will fail the verification.

So just enter the "Subdomain" value.

**2. SPF record already exists / Duplicate SPF records**

Sometimes, you might already have a TXT record for the SPF policy for your sending domain.  This rarely happens, especially when you try to use a subdomain that already exists.

So when you add the second record, the verification will fail.

For example, there will be 2 TXT records that begins with "v=spf1"  for the same "Host Name / Name".&#x20;

Here is an example:&#x20;

<figure><img src="https://837552055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDdKRAW4KzC-CNNbvnH%2Fuploads%2F1r0ShEh8p7hvmqF8yic6%2FScreenshot%202024-01-31%20at%201.53.40%E2%80%AFPM.png?alt=media&#x26;token=cf4ded5e-a2db-4c1b-8480-c919b2ae50e5" alt=""><figcaption><p>Duplicate SPF Records</p></figcaption></figure>

*NOTE: Do not confuse the SPF record for the parent / root domain. Check the "Name" value.* &#x20;

The presence of duplicate records will fail the domain verification. Here is a solution to sort this out:

1. Login to your hosting provider account
2. Go to DNS settings
3. Delete this record: *`v=spf1 include:spf.retainful.net ~all`*
4. Then edit the existing record. For example: `v=spf1 include:_spf.yourdomain.com ~all`
5. Append the value of Retainful's TXT record. So it looks like : `v=spf1 include:spf.retainful.net include:_spf.yourdomain.com ~all`
6. Save

This should help you verify your DNS successfully.

> NOTE: Any DNS change usually takes at least 24 to 48 hours to propagate. So, you might need to wait for some time before clicking on the ‘Verify Domain’ button to verify the DNS records.


---

# 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://help.retainful.com/installation/setting-up-a-sending-domain.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.
