Skip to main content
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)
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.

Add a custom domain

1

Open email settings

Navigate to Organization Settings > Email from the settings sidebar.
2

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.
3

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.
4

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.
5

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.
Repeat these steps for each domain you want to add.

Verification status

After adding DNS records, your domain moves through these states:
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.

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.
Removing a verified domain immediately affects all channels using it. Update your channel settings before removing a domain to avoid sending disruptions.
Last modified on October 5, 2026