Custom Domains

Custom domains allow you to serve your status page from your own domain (like status.yourcompany.com) instead of the default yourname.statuspage.one subdomain. This provides better brand consistency and user trust.

Custom Domain vs Subdomain

Default Subdomain

• URL format: yourname.statuspage.one
• Setup: Immediate, no configuration required
• SSL: Automatically provided by StatusPageOne
• Maintenance: Managed entirely by StatusPageOne
• Best for: Quick setup, internal use, or when custom domains aren't critical

Custom Domain

• URL format: status.yourcompany.com or yourcompany.com/status
• Setup: Requires DNS configuration
• SSL: Automatically provisioned via Let's Encrypt
• Maintenance: StatusPageOne handles SSL renewal
• Best for: Public-facing status pages, brand consistency, SEO benefits

Supported Custom Domain Types

Subdomain (Recommended)

• Format: status.yourcompany.com
• DNS Type: CNAME record
• Setup Difficulty: Easy
• SSL: Automatic
• Best Practice: Industry standard for status pages

Apex Domain

• Format: yourcompany.com (entire domain)
• DNS Type: A record or ALIAS/ANAME
• Setup Difficulty: Moderate
• SSL: Automatic
• Consideration: Uses your entire domain for the status page

Path-Based

• Format: yourcompany.com/status
• Setup: Requires proxy or redirect configuration
• Complexity: Advanced setup required
• Note: Not directly supported; requires custom proxy setup

DNS Configuration

For Subdomains (Recommended)

Step 1: Create CNAME Record

In your DNS management console, create:

Type: CNAME
Name: status (or your preferred subdomain)
Value: yourname.statuspage.one
TTL: 300 (or lowest available)

Step 2: Verify Configuration

After creating the record:

1. Wait 5-10 minutes for DNS propagation
2. Test using dig status.yourcompany.com or nslookup status.yourcompany.com
3. Should show a CNAME pointing to yourname.statuspage.one

For Apex Domains

Option 1: ALIAS/ANAME Record (Preferred)

If your DNS provider supports ALIAS or ANAME records:

Type: ALIAS (or ANAME)
Name: @ (or leave empty for apex)
Value: yourname.statuspage.one
TTL: 300

Option 2: A Record

If ALIAS isn't supported, use A records:

Type: A
Name: @ (or leave empty for apex)
Value: [Contact support for IP addresses]
TTL: 300

Note: A records require specific IP addresses. Contact StatusPageOne support for current IPs.

SSL Certificate Management

Automatic SSL Provisioning

StatusPageOne automatically handles SSL certificates:

• Let's Encrypt integration: Free SSL certificates
• Automatic renewal: Certificates renew before expiration
• Multiple domains: Supports both www and non-www versions
• HTTPS redirect: Automatic redirect from HTTP to HTTPS

Certificate Validation Process

1. Domain verification: StatusPageOne verifies domain ownership
2. Certificate request: Let's Encrypt certificate automatically requested
3. Installation: Certificate automatically installed and configured
4. Monitoring: Certificate expiration monitoring and auto-renewal

Setup Process

Step 1: Configure DNS

1. Log into your DNS management console (Cloudflare, AWS Route 53, GoDaddy, etc.)
2. Create the appropriate DNS record (CNAME for subdomain, ALIAS for apex)
3. Set TTL to 300 seconds for faster propagation
4. Save the DNS record

Step 2: Add Domain in StatusPageOne

1. Navigate to Status Pages > Settings > Custom Domain
2. Enter your custom domain (e.g., status.yourcompany.com)
3. Click Add Custom Domain
4. StatusPageOne will verify the DNS configuration

Step 3: SSL Certificate Provisioning

1. StatusPageOne automatically detects the DNS configuration
2. SSL certificate is requested from Let's Encrypt
3. Certificate installation occurs automatically (usually within 10 minutes)
4. Status will show "Active" when complete

Step 4: Test and Verify

1. Visit your custom domain to verify it loads correctly
2. Check that HTTPS works and shows a valid certificate
3. Verify all links and functionality work properly
4. Test the redirect from your old subdomain (if applicable)

Common DNS Providers

Cloudflare

Type: CNAME
Name: status
Content: yourname.statuspage.one
Proxy status: DNS only (gray cloud)
TTL: Auto

Important: Ensure "DNS only" mode - do not use Cloudflare's proxy (orange cloud).

AWS Route 53

Record name: status
Record type: CNAME
Value: yourname.statuspage.one
TTL: 300

GoDaddy

Type: CNAME
Host: status
Points to: yourname.statuspage.one
TTL: 600

Namecheap

Type: CNAME Record
Host: status
Value: yourname.statuspage.one
TTL: Automatic

Troubleshooting

DNS Propagation Issues

Check DNS Propagation

Use online tools to verify DNS records:

• dig status.yourcompany.com
• nslookup status.yourcompany.com
• Online DNS checkers like whatsmydns.net

Common Solutions

• Wait longer: DNS can take up to 48 hours to propagate globally
• Clear DNS cache: Restart your router or use ipconfig /flushdns (Windows)
• Check TTL: Lower TTL values propagate faster
• Verify record: Ensure the DNS record points to the correct target

SSL Certificate Issues

Certificate Not Provisioning

If SSL certificate doesn't provision automatically:

1. Verify DNS: Ensure DNS points correctly to StatusPageOne
2. Check domain accessibility: Confirm the domain responds to HTTP requests
3. Wait: Certificate provisioning can take up to 24 hours
4. Contact support: If issues persist beyond 24 hours

Mixed Content Warnings

If you see security warnings:

• Check external resources: Ensure all images and resources use HTTPS
• Update links: Change any hardcoded HTTP links to HTTPS
• Browser cache: Clear browser cache and reload

Domain Not Working

"Domain Not Found" Errors

1. DNS configuration: Verify DNS records are correct
2. Propagation: Wait for DNS propagation to complete
3. Case sensitivity: Ensure domain names match exactly
4. Typos: Double-check for spelling errors in DNS records

Redirect Loops

If experiencing redirect loops:

1. Check proxy settings: Disable any proxy services (like Cloudflare proxy)
2. Clear cookies: Clear browser cookies and cache
3. DNS cache: Flush local DNS cache
4. Provider settings: Check for automatic redirect settings in DNS provider

Best Practices

Domain Selection

• Use descriptive subdomains: status., health., or service. are common
• Keep it short: Shorter domains are easier to remember and type
• Match your brand: Use your primary domain for consistency
• Avoid conflicts: Ensure the subdomain isn't already in use

DNS Management

• Use short TTLs: Lower TTL values allow faster changes (300-600 seconds)
• Document changes: Keep records of DNS modifications
• Monitor expiration: Track domain registration expiration dates
• Plan for redundancy: Consider backup DNS providers for critical domains

Security Considerations

• HTTPS everywhere: Never use HTTP for status pages with sensitive information
• Certificate monitoring: Monitor SSL certificate expiration (handled automatically)
• DNS security: Use DNS providers with strong security practices
• Access control: Limit who can modify DNS records

Migration from Subdomain

If you're switching from the default subdomain to a custom domain:

Migration Steps

1. Set up custom domain following the steps above
2. Test thoroughly to ensure everything works
3. Update documentation and communication with the new URL
4. Set up redirects from the old subdomain (optional)
5. Monitor traffic to ensure users are finding the new domain

Communication Strategy

• Announce the change to your team and users
• Update help documentation with the new domain
• Add to website footer with the custom domain
• Social media updates with the new URL

Frequently Asked Questions

Can I use multiple custom domains?

Currently, each status page supports one custom domain. You can redirect additional domains using your DNS provider's redirect services.

What happens to the original subdomain?

The original yourname.statuspage.one subdomain continues to work and can redirect to your custom domain if desired.

Can I change my custom domain later?

Yes, you can change your custom domain at any time through the settings panel. The SSL certificate will be automatically updated.

Do custom domains cost extra?

Custom domains are included with all StatusPageOne plans at no additional cost. You only need to own the domain you want to use.

How long does setup take?

DNS propagation typically takes 5-30 minutes, and SSL certificate provisioning usually completes within 10-60 minutes.

Custom domains provide a professional, branded experience for your status page visitors while maintaining all the functionality and reliability of StatusPageOne's infrastructure.