Skip to content
Docs

Set up a custom domain

Run your client portal at your own address, for example portal.youragency.com, so your clients only ever see your brand. It takes one DNS record, and the portal sets up the SSL certificate for you. A custom domain is also the first step of white label: your logo, login page and advanced branding open once it is verified.

How your custom domain goes live
  1. You

    Save your subdomain

    In Settings, on the White-Label tab.

  2. You

    Add one CNAME record

    At your DNS host, pointing to app.voiceaiportal.com.

  3. Voice AI Portal

    Verifies your domain

    When you select Verify Domain.

  4. Voice AI Portal

    Activates SSL

    The certificate is issued for you, usually within minutes.

  5. Your client

    Signs in on your domain

    With your logo, colours and login page.

  • Owner access. Settings is available to the agency owner only.
  • White label, included on every plan. See pricing.
  • Access to your domain’s DNS settings, wherever your domain’s DNS is hosted.
  • A subdomain to use. For example portal.youragency.com, app.youragency.com or clients.youragency.com. The setup uses a CNAME record, so it works on a subdomain rather than a root domain such as youragency.com.
  1. Open the custom domain settings

    Go to Settings, open the White-Label tab and expand Custom Domain, marked Required.

  2. Save your subdomain

    Type your subdomain into Domain, for example portal.youragency.com, and select Save Domain. The portal registers your domain for SSL straight away.

  3. Copy the DNS record

    A DNS Configuration Required panel shows the record to create. Select the copy button next to Points To to copy the target.

    Field Value
    Type CNAME
    Host Your subdomain prefix, for example portal
    Points To app.voiceaiportal.com
  4. Create the CNAME record at your DNS host

    Sign in where your domain’s DNS is managed and add the record. The steps for common hosts are below.

  5. Wait for DNS to update

    DNS changes usually take 5 to 30 minutes, and some hosts take up to 48 hours.

  6. Verify the domain

    Back in Custom Domain, select Verify Domain. The portal checks that your CNAME points to app.voiceaiportal.com. When it does, you see Domain verified and Custom Domain configured is ticked in Setup progress. If it is not ready yet, select Try Again a little later.

  7. Check SSL is active

    The SSL Status card shows the certificate’s progress, from Initializing SSL… and SSL Provisioning… to SSL Active. This usually takes 1 to 5 minutes once your CNAME is in place. Select Check SSL Status to refresh it; you can check once every 2 minutes, and the portal also checks for you in the background. When the certificate is active, the agency owner gets a “Your custom domain is ready!” email with a link to the branded portal, so you can step away while it finishes.

  8. Open your domain

    When the panel reads “White-label is active”, open https://portal.youragency.com (your own subdomain) in a new tab. You should see the sign-in page. Sign in to check everything works.

Next, add your logo and login page. See Configure your branding.

Whatever your DNS host, the record is the same. Replace portal with your own subdomain prefix.

Field Value
Type CNAME
Name or host portal
Target, value or points to app.voiceaiportal.com
TTL Auto, or 3600
  1. In Cloudflare, select your domain and open DNS, then Records.
  2. Select Add record and choose CNAME.
  3. Enter your prefix as Name and app.voiceaiportal.com as Target.
  4. Set Proxy status to DNS only (grey cloud).
  5. Save.

If your domain uses Cloudflare, the portal detects it and shows a Cloudflare DNS detected reminder to turn the proxy off.

  • One domain for everyone. You and your clients can both sign in on your custom domain.
  • Separate sign-ins. Your custom domain and app.voiceaiportal.com keep separate sessions, so you sign in separately on each.
  • Emails link to your domain. Once your domain is live (verified, with SSL active), sign-in links in your emails point to it. To send those emails from your own address too, connect your own email sender. See Configure custom email.
  • Your custom domain is for the portal. Email is sent from a separate sending domain that you verify with your email service, often a subdomain such as mail.youragency.com.
  • Changing or removing the domain. To use a different subdomain, save the new one and add its CNAME record. Remove Domain takes the domain off and turns white-label access off until you set a domain up again.
  • Unfinished setups. If a saved domain is never verified, the portal clears it after a few days so you can start again with a clean setup.
Problem What to do
Verification failed Check the record is a CNAME, not an A record, and that it points to app.voiceaiportal.com exactly. View Details shows what the portal found. Wait for DNS to update and select Try Again.
You use Cloudflare and verification keeps failing Set the record to DNS only (grey cloud).
The record shows the domain twice, such as portal.youragency.com.youragency.com Your host adds the domain for you. Enter only the prefix.
“Root/apex domains are not supported” Use a subdomain such as portal.youragency.com.
“This domain is already in use by another agency” Choose a different subdomain, or email us if the domain is yours.
SSL still shows as provisioning Check the CNAME is in place and, on Cloudflare, set to DNS only. Then select Check SSL Status after a few minutes.
Your saved domain has gone It was not verified within a few days, so it was cleared. Save it again and add the CNAME record.

If you are stuck, email hello@voiceaiportal.com with your subdomain and a screenshot of your DNS record.