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

# Domain Settings

> Configure and verify sending domains for email delivery

Domain settings manage the email domains used for sending campaigns. Proper domain configuration is essential for email deliverability.

## Why Domain Verification Matters

Verified domains:

* Improve inbox placement
* Protect against spoofing
* Build sender reputation
* Enable tracking features

Without verification, emails may:

* Land in spam folders
* Be rejected by receivers
* Show security warnings
* Have limited tracking

## Accessing Domain Settings

Navigate to **Settings → Domains** from the sidebar.

## Quick Start: RevBridge Test Domain

Get started sending emails immediately with a RevBridge-managed subdomain — no DNS configuration required.

<Steps>
  <Step title="Enter Sender Name">
    Enter a sender name (e.g., "Tyler" or "Marketing")
  </Step>

  <Step title="Preview Address">
    The system previews your sending address: `sender@yourcompany.revbridge.com.br`
  </Step>

  <Step title="Save">
    Click Save to provision the subdomain automatically
  </Step>
</Steps>

The RevBridge test domain is provisioned instantly and has a daily send limit of **5,000 emails**. This is ideal for testing campaigns and getting started quickly.

<Info>
  The RevBridge test domain uses your company slug as the subdomain. For production sending with your own branding, set up a custom domain below.
</Info>

## Adding a Custom Domain

For production use, configure your own domain for full control over sender reputation and branding.

<Steps>
  <Step title="Click Add Domain">
    Click the **Add Domain** button
  </Step>

  <Step title="Enter Domain and Senders">
    Enter your sending domain (e.g., `acme.com` or `mail.acme.com`) and optionally add multiple named senders (e.g., `tyler@acme.com`). A live email preview shows how each sender identity will appear in recipients' inboxes
  </Step>

  <Step title="Get DNS Records">
    RevBridge auto-generates the required DNS records for your domain
  </Step>

  <Step title="Add Records">
    Add the records to your DNS provider using the one-click copy buttons and provider-specific guides
  </Step>

  <Step title="Verify">
    Click **Verify Domain** to check your DNS configuration
  </Step>

  <Step title="Wait for Provisioning">
    After verification, the sending server is provisioned automatically (up to 24 hours)
  </Step>
</Steps>

### Domain Lifecycle

| Status       | Meaning                                                |
| ------------ | ------------------------------------------------------ |
| **Pending**  | Domain added, awaiting DNS verification                |
| **Verified** | DNS records confirmed, server provisioning in progress |
| **Ready**    | Fully provisioned and ready to send                    |

<Info>
  The system polls your domain status every 30 seconds and automatically selects the best available domain (preferring domains in "Ready" status).
</Info>

## Auto-Generated DNS Records

When you add a custom domain, RevBridge automatically generates 6 DNS records:

### CNAME Records (3)

| Purpose            | Host            | Points To                       |
| ------------------ | --------------- | ------------------------------- |
| Main subdomain     | Your domain     | `rbc{id}.zn{zone}.revbridge.ai` |
| API subdomain      | API prefix      | `rbc{id}.zn{zone}.revbridge.ai` |
| Tracking subdomain | Tracking prefix | `rbc{id}.zn{zone}.revbridge.ai` |

### DKIM Records (2)

| Purpose    | Host               | Points To             |
| ---------- | ------------------ | --------------------- |
| DKIM Key 1 | `rbds1._domainkey` | Provided in dashboard |
| DKIM Key 2 | `rbds2._domainkey` | Provided in dashboard |

### DMARC Record (1)

| Purpose      | Type | Host     | Value                                                     |
| ------------ | ---- | -------- | --------------------------------------------------------- |
| DMARC Policy | TXT  | `_dmarc` | `v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com` |

<Accordion title="Merging with existing SPF records">
  If you already have an SPF record, add RevBridge to it:

  **Existing**: `v=spf1 include:_spf.google.com ~all`
  **Updated**: `v=spf1 include:_spf.google.com include:_spf.revbridge.ai ~all`
</Accordion>

## DNS Configuration by Provider

<Accordion title="GoDaddy">
  1. Log into GoDaddy account
  2. Go to DNS Management
  3. Click Add Record
  4. Select record type (TXT for SPF/DKIM/DMARC)
  5. Enter host and value
  6. Save
  7. Wait for propagation (up to 48 hours)
</Accordion>

<Accordion title="Cloudflare">
  1. Log into Cloudflare dashboard
  2. Select your domain
  3. Go to DNS settings
  4. Click Add Record
  5. Enter type, name, and content
  6. Save
  7. Propagation is usually fast (minutes)
</Accordion>

<Accordion title="Namecheap">
  1. Log into Namecheap
  2. Go to Domain List → Manage
  3. Click Advanced DNS
  4. Add New Record
  5. Select type and enter values
  6. Save changes
  7. Wait for propagation
</Accordion>

<Accordion title="Route 53 (AWS)">
  1. Log into AWS Console
  2. Go to Route 53
  3. Select Hosted Zone
  4. Click Create Record
  5. Enter record details
  6. Create records
  7. Propagation usually fast
</Accordion>

## Verification

### Checking Status

Each DNS record shows individual verification status. Click **Verify Domain** to re-check after making DNS changes.

Once all records are verified, the domain enters the provisioning phase where RevBridge sets up your dedicated sending infrastructure. This typically takes up to 24 hours.

### Domain Selection

When multiple domains are configured, the system automatically selects the best available domain based on status priority (Ready > Verified > Pending). Your selection is remembered across sessions.

## Multiple Domains

You can add multiple sending domains:

| Use Case                       | Example                                    |
| ------------------------------ | ------------------------------------------ |
| **Different brands**           | brand1.com, brand2.com                     |
| **Marketing vs transactional** | marketing.acme.com, notifications.acme.com |
| **Regional**                   | acme.com, acme.co.uk                       |

### Selecting Domain for Campaigns

When creating a campaign, select which verified domain to send from.

## Subdomain Strategy

Consider using subdomains for marketing email:

**Benefits**:

* Isolate marketing reputation from corporate email
* Easier to warm up new subdomain
* Protect main domain reputation

**Examples**:

* `mail.acme.com`
* `news.acme.com`
* `offers.acme.com`

<Tip>
  Start with a subdomain for marketing. If reputation issues occur, they won't affect your main domain email.
</Tip>

## Domain Warm-Up

New domains need gradual volume increase:

### Warm-Up Schedule

| Week | Daily Volume | Notes                     |
| ---- | ------------ | ------------------------- |
| 1    | 50-100       | Most engaged subscribers  |
| 2    | 200-500      | Expand to engaged         |
| 3    | 500-1,000    | Monitor metrics closely   |
| 4    | 1,000-5,000  | Scale if metrics are good |
| 5+   | 5,000+       | Continue scaling          |

### Warm-Up Best Practices

* Start with your most engaged subscribers
* Monitor bounce and complaint rates
* Slow down if metrics decline
* Maintain consistent sending patterns

## Troubleshooting

### DNS Records Not Found

1. Double-check record values
2. Verify correct host/subdomain
3. Wait longer for propagation (up to 48 hours)
4. Use DNS lookup tool to verify
5. Check with your DNS provider

### SPF Record Issues

* Only one SPF record allowed per domain
* Merge multiple includes into one record
* Check for typos in the record

### DKIM Not Verifying

* Ensure exact copy of provided value
* Check for extra spaces or line breaks
* Verify correct host (revbridge.\_domainkey)

### DMARC Warnings

DMARC policies:

* `p=none` - Monitor only (start here)
* `p=quarantine` - Send failures to spam
* `p=reject` - Reject failures (strictest)

Start with `p=none` while warming up, then increase strictness.

## Removing a Domain

To remove a domain:

1. Go to **Settings → Domains**
2. Find the domain
3. Click **Remove**
4. Confirm removal

<Warning>
  Removing a domain prevents sending from that address. Campaigns using this domain will fail.
</Warning>