insights.yourcompany.com) to access Surfacd with your branding.
Overview
Custom domains allow your team to access Surfacd at a URL you control, such as:insights.yourcompany.comai-analytics.yourcompany.com
Contact your account manager to enable this feature.
How It Works
- You choose a subdomain on your domain (e.g.,
insights.yourcompany.com) - You add a DNS record pointing to our service
- We automatically provision an SSL certificate
- Your team accesses Surfacd at your custom URL
yourteam.surfacd.com) continues to work alongside your custom domain.
Setup Instructions
Step 1: Choose Your Domain
Pick a subdomain you’d like to use. Common choices:insights.yourcompany.comsurfacd.yourcompany.comai.yourcompany.comvisibility.yourcompany.com
Step 2: Request Custom Domain
Contact your Surfacd account manager or support team with your desired domain. They will register it in our system.Step 3: Add DNS Record
Add a CNAME record in your DNS provider:| Type | Name | Target |
|---|---|---|
| CNAME | insights (or your chosen subdomain) | custom.surfacd.com |
- Cloudflare
- Route 53
- Other Providers
- Go to your domain’s DNS settings
- Click Add Record
- Select CNAME as the type
- Enter your subdomain name (e.g.,
insights) - Enter
custom.surfacd.comas the target - Disable the proxy (grey cloud) - this is important
- Click Save
Step 4: Wait for Verification
After adding the DNS record:- DNS propagation takes 5 minutes to 48 hours (usually under 1 hour)
- SSL certificate is automatically provisioned
- Your administrator will confirm when the domain is active
Step 5: Access Your Custom Domain
Once active, visit your custom domain (e.g.,https://insights.yourcompany.com).
You’ll need to log in again on your custom domain. Sessions are separate between domains for security.
Troubleshooting
Domain Shows “Pending”
The DNS record hasn’t been detected yet. Check that:- The CNAME record is correctly configured
- You’re using a subdomain, not the root domain
- DNS has had time to propagate (wait up to 1 hour)
- If using Cloudflare, the proxy is disabled (grey cloud)
SSL Certificate Error
SSL certificates are provisioned automatically. If you see certificate errors:- Wait 15-30 minutes for the certificate to be issued
- Ensure no CAA records are blocking certificate issuance
- Contact your administrator if issues persist
Can’t Log In
If you’re redirected back to the login page:- Clear your browser cookies for the domain
- Ensure you’re a member of the team that owns the custom domain
- Try using an incognito/private browser window
FAQ
Can I use my root domain?
Can I use my root domain?
No, custom domains must be subdomains (e.g.,
insights.yourcompany.com). Root domains (yourcompany.com) are not supported due to DNS limitations with CNAME records.Will my team subdomain stop working?
Will my team subdomain stop working?
No, your existing team subdomain (e.g.,
yourteam.surfacd.com) continues to work. You can use both.Is my data separate between domains?
Is my data separate between domains?
No, both domains access the same team and data. Only the login session is separate for security.
Can I change my custom domain later?
Can I change my custom domain later?
Yes, contact your administrator to update your custom domain. Note that any bookmarks or shared links to the old domain will stop working.
Do I need to renew the SSL certificate?
Do I need to renew the SSL certificate?
No, SSL certificates are automatically renewed before expiration.