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

# Custom email domains

> Configure custom email domains so outbound messages from Ravenna use your organization's domains instead of mail.ravenna.ai.

By default, Ravenna sends outbound email from `mail.ravenna.ai`. Configure one or more custom email domains to send from your own domains instead, improving brand recognition and email deliverability.

## Prerequisites

Before you start, confirm you have:

* Organization admin access in Ravenna
* Access to your domain's DNS management (e.g., Cloudflare, Route 53, GoDaddy)
* The domain you want to send from (e.g., `support.yourcompany.com`)

<Info>
  You can configure a subdomain (like `support.yourcompany.com`) or your root domain. Subdomains are recommended so existing email delivery is not affected. Ravenna verifies ownership through DKIM DNS records, so any domain you control can be added.
</Info>

***

## Add a custom domain

<Steps>
  <Step title="Open email settings">
    Navigate to **Organization Settings > Email** from the settings sidebar.
  </Step>

  <Step title="Add your domain">
    Click **Add Domain** and enter the domain you want to send from. Ravenna generates the DKIM DNS records you need to add.
  </Step>

  <Step title="Copy DNS records">
    Click the domain to expand it and view the DKIM records (CNAME entries) required for verification. Copy each record's name and value.
  </Step>

  <Step title="Add records to your DNS provider">
    Log in to your DNS provider and create the CNAME records shown in Ravenna. The exact steps vary by provider, but you typically navigate to DNS settings for your domain and add each record as a new CNAME entry.
  </Step>

  <Step title="Verify the domain">
    Click **Verify Domain**. Ravenna checks that the DNS records resolve correctly. If verification fails, wait a few minutes for DNS propagation and try again.
  </Step>
</Steps>

Repeat these steps for each domain you want to add.

***

## Verification status

After adding DNS records, your domain moves through these states:

| Status | Meaning |
| - | - |
| **Pending** | DNS records have not been verified yet. Click **Verify** to check. |
| **Verified** | All DNS records are correctly configured. The domain is ready to use. |
| **Failed** | Verification could not confirm the DNS records. Check your DNS configuration and retry. |

<Info>
  DNS changes can take up to 48 hours to propagate, though most providers propagate within minutes. If verification fails immediately after adding records, wait and retry.
</Info>

***

## Use verified domains

Once verified, your custom domains become available as the sender for outbound email. Configure them at two levels:

### Organization-level sender

Under **Organization Settings > Email**, set a default sender name and address. If you have multiple verified domains, select which domain to use from the dropdown.

### Channel-level sender

Override the organization default for a specific channel:

1. Navigate to **Workspace Settings > Channels**
2. Select a channel and open its email settings
3. Set a sender address using any of your verified domains

All outbound email from that channel (replies, notifications, and automated messages) will use the configured domain. Channels without a custom sender inherit the organization-level setting.

***

## Troubleshooting

**Verification keeps failing:**

* Confirm the CNAME records match exactly (no trailing dots unless your provider requires them)
* Check that you added records to the correct domain or subdomain
* Wait at least 15 minutes after adding records before verifying
* Use a DNS lookup tool to confirm the records are publicly resolvable

**Email delivery issues after verification:**

* Ensure your domain does not have conflicting SPF or DMARC records that reject messages from Ravenna's sending infrastructure
* Check that the domain is not on any blocklists

***

## Remove a domain

To remove a custom domain, navigate to **Organization Settings > Email**, open the domain's overflow menu, and click **Remove Domain**. Channels using that domain revert to sending from `mail.ravenna.ai`.

<Warning>
  Removing a verified domain immediately affects all channels using it. Update your channel settings before removing a domain to avoid sending disruptions.
</Warning>


## Related topics

- [Organization settings](/documentation/platform/organizations/settings.md)
- [Triggers & actions](/documentation/automate/workflows/triggers-actions.md)
- [Product Updates](/changelog/2026.md)
- [Add email domain](/api/emaildomain/add-email-domain.md)
- [Delete email domain](/api/emaildomain/delete-email-domain.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.