Skip to main content

​
Overview

Custom domains let you serve shared reports from your own subdomain (e.g., reports.youragency.com) instead of the default SEO Crawler domain. This provides a seamless branded experience for your clients.
Available on: Agency plan only

​
Benefits

Professional Branding

Clients see your domain, reinforcing your brand.

Trust & Credibility

Clients trust links from domains they recognize.

White-Label Complete

No visible connection to SEO Crawler.

Custom Email Sender

Send reports from your own email domain.

​
How It Works

Without Custom Domain:
─────────────────────────────────────────
Share URL: app.seocrawler.app/share/abc123
Email From: reports@seocrawler.app

With Custom Domain:
─────────────────────────────────────────
Share URL: reports.youragency.com/share/abc123
Email From: reports@youragency.com

​
Setting Up a Custom Domain

1

Choose Your Subdomain

Select a subdomain for your reports:Common choices:
  • reports.youragency.com
  • insights.youragency.com
  • seo.youragency.com
  • audit.youragency.com
You must use a subdomain, not your root domain. This is required for proper SSL and routing.
2

Add Domain in Settings

  1. Go to Settings → Custom Domain
  2. Enter your chosen subdomain
  3. Click Add Domain
You’ll receive DNS configuration instructions.
3

Configure DNS

Add a CNAME record pointing to our servers:
FieldValue
TypeCNAME
Name/Hostreports (or your chosen subdomain)
Target/Valuecustom.seocrawler.app
TTL300 (or Auto)
4

Verify Domain

Click Verify Domain after adding the CNAME record.
DNS changes can take up to 48 hours to propagate, though most complete within 15 minutes.
5

SSL Provisioning

We automatically provision an SSL certificate for your custom domain. This may take up to 10 minutes after verification.

​
DNS Configuration by Provider

1

Open DNS Settings

Go to your domain → DNS → Records
2

Add CNAME Record

FieldValue
TypeCNAME
Namereports
Targetcustom.seocrawler.app
Proxy statusDNS only (gray cloud)
Disable Cloudflare proxy (orange cloud) for this record. Our SSL requires direct connection.
3

Save

Click Save to create the record.

​
Verifying Your Setup

​
Check DNS Propagation

Verify your CNAME record is active: 
# macOS/Linux
dig CNAME reports.youragency.com +short

# Expected output:
custom.seocrawler.app.

# Windows
nslookup -type=CNAME reports.youragency.com

# Expected output:
reports.youragency.com    canonical name = custom.seocrawler.app

​
Check SSL Certificate

After verification, test SSL: 
curl -I https://reports.youragency.com
You should see HTTP/2 200 and valid SSL headers.

​
Custom Email Domain

To send emails from your domain (e.g., reports@youragency.com):

​
Additional DNS Records

Add these records to your DNS:
TypeNameValue
TXT_dmarcv=DMARC1; p=none; rua=mailto:dmarc@youragency.com
TXTlhm._domainkey(Provided in settings)
TXT@ or rootv=spf1 include:_spf.seocrawler.app ~all

​
Verifying Email Setup

  1. Go to Settings → Custom Domain → Email Settings
  2. Click Verify Email DNS
  3. Green checkmarks indicate successful configuration
Email DNS Status
─────────────────────────────────────────
SPF Record:     ✓ Verified
DKIM Record:    ✓ Verified  
DMARC Record:   ✓ Verified

Email sending enabled from: reports@youragency.com

​
Managing Custom Domains

​
Changing Your Domain

To switch to a different custom domain:
  1. Go to Settings → Custom Domain
  2. Click Remove Current Domain
  3. Add your new domain
  4. Update DNS records
  5. Re-verify
Existing share links using the old domain will stop working. Update any shared links before removing.

​
Multiple Custom Domains

Agency plans support one custom domain. Need multiple?
  • Contact sales for Enterprise pricing
  • Use subdomain paths for different clients: reports.youragency.com/client-a/

​
Removing a Custom Domain

To revert to the default SEO Crawler domain:
  1. Go to Settings → Custom Domain
  2. Click Remove Custom Domain
  3. Confirm removal
Share links will revert to using the default domain.

​
Troubleshooting

Check these common issues:
  1. CNAME not propagated: Wait 15-30 minutes and retry
  2. Wrong target: Ensure CNAME points to custom.seocrawler.app exactly
  3. Cloudflare proxy enabled: Disable orange cloud (use DNS only)
  4. Conflicting records: Remove any A records for the same subdomain
Debug command:
dig CNAME reports.youragency.com +trace
SSL provisioning can take up to 10 minutes. If issues persist:
  1. Verify CNAME is correct with dig
  2. Ensure no Cloudflare/CDN proxy is interfering
  3. Wait 30 minutes for certificate propagation
  4. Contact support if issues continue
Ensure all email DNS records are properly configured:
  1. SPF record must include our servers
  2. DKIM record must be present
  3. DMARC record should be configured
Test with Mail Tester.

​
Best Practices

Use a Dedicated Subdomain

Don’t use subdomains that might conflict with existing services.

Set Up Email DNS

Complete email configuration for full white-label experience.

Test Before Sharing

Always test new share links before sending to clients.

Monitor SSL Expiry

We auto-renew, but monitor for any certificate issues.

​
Next Steps

White-Labeling

Complete your branding setup.

Client Management

Organize domains by client.