Skip to main content

​
Overview

By default, your status page is accessible at a subdomain like yourcompany.statuspage.one. With a custom domain, you can use your own domain such as status.yourcompany.com for a more professional appearance. Domain Configuration

​
Accessing Domain Settings

  1. Navigate to Status Pages in the sidebar
  2. Select your status page
  3. Click Settings
  4. Select the Domain tab

​
Domain Options

​
Default Subdomain

Option: Use a subdomain on statuspage.one Format: yourcompany.statuspage.one Advantages:
  • ✓ No DNS configuration required
  • ✓ SSL certificate automatically provided
  • ✓ Works immediately
  • ✓ No additional cost
Disadvantages:
  • ✗ Less professional appearance
  • ✗ Uses StatusPage.one branding in URL

​
Custom Domain

Option: Use your own domain Format: status.yourcompany.com Advantages:
  • ✓ Professional, branded appearance
  • ✓ Matches your company domain
  • ✓ Better trust and recognition
  • ✓ Custom SSL certificate included
Disadvantages:
  • ✗ Requires DNS configuration
  • ✗ Takes time for DNS propagation
Most companies use a subdomain like status.yourcompany.com or health.yourcompany.com rather than a separate domain.

​
Setting Up a Custom Domain

1

Choose Custom Domain Option

Select CUSTOM DOMAIN in the Domain Type section.
2

Enter Your Domain

Type your custom domain in the CUSTOM DOMAIN field (e.g., status.yourcompany.com).
3

Save Configuration

Click Save or similar action to save your domain configuration.
4

Configure DNS

After saving, you’ll receive DNS configuration instructions. You need to add a CNAME record at your DNS provider.
5

Wait for Verification

DNS changes can take 1-48 hours to propagate. Once verified, you’ll see “Domain Verified” status.

​
DNS Configuration

After entering your custom domain, you’ll need to configure DNS settings with your domain provider.

​
CNAME Record Setup

You’ll need to create a CNAME record pointing to your StatusPage.one domain: 
Type: CNAME
Name: status (or your chosen subdomain)
Value: [provided by StatusPage.one]
TTL: 3600 (or automatic)
Example: 
status.yourcompany.com → CNAME → cname.vercel-dns.com

​
Where to Add DNS Records

Popular DNS providers:
  • Cloudflare - DNS → Records → Add record
  • AWS Route 53 - Hosted zones → Create record
  • Google Domains - DNS → Custom records
  • Namecheap - Advanced DNS → Add new record
  • GoDaddy - DNS Management → Add record
Do not use an A record. Custom domains require a CNAME record to work properly.

​
Verification Status

After configuring DNS, the system will automatically check for verification:

​
Domain Verified (Green checkmark)

✓ DNS is configured correctly ✓ Custom domain is active ✓ Status page is accessible at your custom domain ✓ SSL certificate is provisioned

​
Pending Verification

⏳ DNS records not yet detected ⏳ Waiting for DNS propagation ⏳ May take up to 48 hours
DNS propagation typically takes 15 minutes to 2 hours, but can take up to 48 hours in some cases.

​
Current URLs

The settings page shows both URLs: Default URL:
  • Your original StatusPage.one subdomain
  • Badge labeled “Default”
  • Always remains accessible as a backup
Custom Domain (Primary):
  • Your custom domain after verification
  • Marked as primary once verified
  • “Domain Verified” status indicator
  • Remove button to delete custom domain

​
Troubleshooting

Check:
  • CNAME record is correct (no typos)
  • Using CNAME, not A record
  • No conflicting records for the same subdomain
  • DNS changes have saved (check with dig status.yourcompany.com)
Solution: Verify DNS settings with your provider’s documentation or support.
Cause: Certificate is still being provisioned.Solution: Wait 10-15 minutes after DNS verification. SSL certificates are generated automatically.
Cause: DNS is not pointing to the correct target, or verification hasn’t completed.Solution: Double-check your CNAME value matches exactly what was provided.
Solution: Click Remove on the current custom domain, then add your new domain following the setup steps.

​
Best Practices

The subdomain status.yourcompany.com is industry standard and users expect to find status pages there.
When first configuring DNS, use a low TTL (300-600 seconds) so you can make changes quickly if needed. Increase it once verified.
After verification, test your custom domain in different browsers and networks before sharing publicly.
Don’t remove your default StatusPage.one URL. It serves as a backup if DNS issues occur.

​
Common Subdomains

SubdomainExamplePurpose
statusstatus.company.comMost common choice
healthhealth.company.comAlternative option
uptimeuptime.company.comEmphasizes reliability
availabilityavailability.company.comMore formal

​
Removing a Custom Domain

To remove your custom domain and revert to the default:
  1. Navigate to Settings → Domain tab
  2. Click Remove next to your custom domain
  3. Confirm the removal
  4. Your status page will be accessible only at the default URL
After removing a custom domain, any links to the custom URL will stop working. Update all references before removing.

​
SSL Certificates

SSL certificates for custom domains are:
  • ✓ Automatically provisioned
  • ✓ Automatically renewed
  • ✓ Free (included with your plan)
  • ✓ Full SSL/TLS encryption
  • ✓ Modern browser compatible
You don’t need to upload or manage certificates manually.

​
Next Steps

Embed Badges

Add status badges using your custom domain

Customize Branding

Adjust colors and appearance

Components

Organize monitors on your status page

Status Page Overview

Back to status pages overview