Skip to Content
DocsSettingsCustom Domain

Custom Domain Growth+ plan required

By default, your clients access the portal at a BuildVoiceAI subdomain. With a custom domain, you can point your own domain (like portal.youragency.com) at the client portal for a fully branded experience.

Custom domains are available on Growth and Agency plans.

Custom domain settings showing domain input, DNS instructions, and verification status

Setting Up Your Custom Domain

Step 1: Choose Your Domain

Decide on the subdomain you want to use. Common choices:

  • portal.youragency.com
  • app.youragency.com
  • clients.youragency.com

You must use a subdomain (e.g., portal.youragency.com), not a root domain (e.g., youragency.com).

Step 2: Add the Domain in BuildVoiceAI

  1. Go to Settings → Custom Domain
  2. Enter your chosen subdomain
  3. Click Save

BuildVoiceAI will display the DNS records you need to configure.

Step 3: Configure DNS Records

Add the following records at your domain registrar or DNS provider:

Record TypeHostValue
CNAMEportal (or your chosen subdomain)Provided by BuildVoiceAI
TXT_buildvoiceai-verify.portalProvided by BuildVoiceAI

The CNAME record routes traffic to the client portal. The TXT record proves you own the domain.

DNS configuration example at a domain registrar
Example DNS setup at a typical registrar
💡

If you use Cloudflare, make sure the CNAME proxy status is set to DNS only (grey cloud) during initial setup. You can enable the proxy after verification completes.

Step 4: Verify the Domain

After configuring DNS, return to Settings → Custom Domain and click Verify. DNS propagation can take anywhere from a few minutes to 48 hours, though most records propagate within 15 minutes.

The verification status will show one of:

  • Pending — DNS records not yet detected. Wait and try again.
  • Verified — Domain is active and SSL certificate has been provisioned.
  • Error — DNS records are incorrect. Review the required values and update.

SSL Certificate

Once your domain is verified, an SSL certificate is automatically provisioned and renewed. Your clients will access the portal over HTTPS with no additional configuration needed.

How Clients Access the Portal

After setup, clients can log in at https://portal.youragency.com (or whatever subdomain you chose). The default BuildVoiceAI URL will continue to work as well.

You can share the custom domain URL in your onboarding materials, email templates, and documentation for a consistent branded experience.

Changing or Removing a Custom Domain

To change your domain, update the domain field and repeat the DNS and verification steps. To remove a custom domain entirely, clear the field and save. Clients will revert to using the default BuildVoiceAI URL.

⚠️

Removing or changing your custom domain means any bookmarks or links your clients have saved to the old domain will stop working. Communicate changes to your clients in advance.

Troubleshooting

Verification Stuck on Pending

  • Confirm DNS records are saved at your registrar
  • Use a tool like dnschecker.org  to verify propagation
  • Ensure there are no conflicting records for the same subdomain
  • Wait at least 15 minutes before retrying

SSL Certificate Not Working

  • SSL provisioning happens automatically after verification and can take up to 10 minutes
  • If the certificate does not appear after 30 minutes, remove and re-add the domain
Last updated on