Custom Domains

Learn how to connect your own custom domain (e.g., deals.yourcompany.com) to your company promotion pages for a branded experience.

Overview

Custom domains allow you to use your own branded URLs instead of the default yourcompany.donaraz.app format. This provides a more professional and branded experience for your customers.

Example: Instead of yourcompany.donaraz.app/promotion-slug, you can use deals.yourcompany.com/promotion-slug

Getting Started

To set up a custom domain:

Go to Company Settings → Custom Domains
Click "Add Custom Domain" or "Manage Domains"
Enter your domain name (e.g., deals.yourcompany.com)
Click "Create Domain"
Follow the DNS configuration steps below

DNS Configuration

After creating your custom domain, you'll need to add DNS records at your domain provider. The platform will provide you with the exact records needed:

Step 1: Ownership Verification

Add a TXT record to prove you own the domain:

Type: TXT
Name: _cf-custom-hostname (or as specified)
Value: (Provided by the platform)

Step 2: Domain Routing

Add a DNS record to route your domain:

For subdomains: Add a CNAME record pointing to your company subdomain
For apex domains (root domains): Add an ALIAS record (if supported) or A records pointing to Cloudflare IPs

Important for Cloudflare users: If your domain is hosted on Cloudflare, the CNAME record must be in DNS-only mode (gray cloud, not proxied). Turn off the proxy (orange cloud) for the CNAME record.

Step 3: SSL Certificate

After ownership verification, the platform will automatically generate SSL validation records:

Add the _acme-challenge TXT record provided
The SSL certificate will be automatically issued once DNS records are verified

Domain Verification

After adding DNS records:

Wait a few minutes for DNS propagation (can take up to 48 hours, but usually completes within minutes)
Go back to the Custom Domains section
Select your domain and click "Verify Domain"
The platform will check if your DNS records are correctly configured

Tip: DNS changes can take time to propagate. If verification fails, wait a few minutes and try again.

Domain Status

Your domain will show different statuses during setup:

Pending - Waiting for DNS records to be added
PENDING_VALIDATION - Validating DNS records
Active - Domain is active and working
Failed - Verification failed (check DNS records)

Main Domain

You can set one domain as your main domain. The main domain is used as the default when multiple domains are configured.

The first domain you add is automatically set as the main domain
You can change the main domain at any time
Only one domain can be the main domain at a time

Managing Domains

Once your domain is active, you can:

Set as Main Domain: Make this domain your primary domain
Restart SSL Validation: If SSL certificate issuance has stalled
Fix Origin Server: If you see errors about the origin server
Delete Domain: Remove the domain (cannot be undone)

Warning: Deleting a domain is permanent and cannot be undone. Make sure to set another domain as main before deleting your main domain.

Troubleshooting

Domain verification fails

Double-check that DNS records are correctly added at your domain provider
Wait a few minutes for DNS propagation
Verify the record values match exactly (no extra spaces or characters)
For Cloudflare users, ensure CNAME is in DNS-only mode (gray cloud)

SSL certificate not issuing

Ensure the _acme-challenge TXT record is added correctly
Click "Restart SSL Validation" to retry
Wait for DNS propagation (can take up to 48 hours)

Domain not routing correctly

Verify CNAME/ALIAS records point to the correct target
Check that DNS records have propagated (use DNS lookup tools)
Try the "Fix Origin Server" option if using a wildcard setup

Best Practices

Use subdomains (e.g., deals.yourcompany.com) rather than apex domains when possible
Keep DNS records updated and verified
Monitor domain status regularly
Set up multiple domains for redundancy if needed
Always verify DNS records before marking domains as production-ready