Web domains allow you to serve your capture pages on a custom domain (e.g., `pages.yourdomain.com` or `subscribe.yourdomain.com`) instead of the default Lumail.io subdomain.

## Why Use a Custom Web Domain?

- **Brand Consistency**: Your capture pages appear on your own domain
- **Trust**: Visitors see your domain in the URL bar
- **SEO Benefits**: Build domain authority on your own domain
- **Professional Appearance**: Remove third-party branding from URLs

## Adding a Web Domain

1. Go to **Domains** in your organization settings
2. Click **Add Web Domain**
3. Enter your subdomain (e.g., `pages.yourdomain.com`)
4. Click **Create**

Each plan includes a fixed number of web domains: **1 on Free and Creator, 3 on Pro, 5 on Business**. Capture pages still work on the default Lumail URL if you hit the cap. When you do, **Upgrade** opens the billing plan page.

## DNS Configuration

After adding your domain, configure a CNAME record at your domain registrar:

| Type  | Host                        | Value             | TTL  |
| ----- | --------------------------- | ----------------- | ---- |
| CNAME | `pages` (or your subdomain) | `cname.lumail.io` | 3600 |

That is the only record. Do not point the domain at a raw VPS IP.

## Verification Process

1. Add the CNAME at your DNS provider
2. Return to Lumail.io and click **Check DNS Records Status**
3. SSL is issued automatically once the CNAME is live

## Using Your Web Domain

Once verified, your capture pages are automatically available at your custom domain:

- **Before**: `lumail.io/p/your-org/page-slug`
- **After**: `pages.yourdomain.com/page-slug`

All existing capture page links continue to work. The custom domain is an additional way to access your pages.

## Apex Domains vs Subdomains

### Subdomains (Recommended)

Use a subdomain like `pages.yourdomain.com` or `subscribe.yourdomain.com`:

| Type  | Host    | Value             |
| ----- | ------- | ----------------- |
| CNAME | `pages` | `cname.lumail.io` |

### Apex Domains

For apex domains (e.g., `yourdomain.com` without a subdomain), create a CNAME or ALIAS for `@` to `cname.lumail.io`. This requires CNAME flattening (Cloudflare DNS) or an ALIAS/ANAME record. A plain A record will not work.

Subdomains are recommended.

## Troubleshooting

### Domain stuck on "Pending"

- **Check CNAME**: It must be `cname.lumail.io`
- **DNS Propagation**: Wait up to 48 hours for DNS changes to propagate
- **Use dig**: Run `dig pages.yourdomain.com` to check if the record exists

### SSL Certificate Issues

Certificates are issued after Cloudflare sees the hostname. If you see certificate warnings:

- Wait a few minutes after DNS is correct
- Clear your browser cache and try again
- Confirm the CNAME is `cname.lumail.io` and that there is no conflicting A record

## Related Documentation

- [V0 Capture Page Tutorial](/docs/tutorials/v0-capture-page) - Build capture pages to host on your domain
- [Create Subscriber API](/docs/api-reference/api-subscribers-post) - Capture page form integration