Skip to main content
White-Label Client Portal

Connect Your Custom Domain

Put the client portal on your own subdomain, such as portal.yourbrand.com, with a free SSL certificate.

Written By voiceaiwrapper

Last updated 26 days ago

Your clients log in to their portal on your own subdomain, such as portal.yourbrand.com, instead of a VoiceAIWrapper address. You set this up once by adding a DNS record with your domain provider. VoiceAIWrapper then checks the record and sets up a free SSL certificate for you.

Most setups take 2 to 5 minutes, plus however long your DNS provider takes to publish the change.

Available on: plans that include Custom domain. Without it, clicking Add subdomain shows an upgrade prompt.

Before you start

You'll need:

  • A domain you own, such as yourbrand.com.
  • Access to your DNS settings. This is usually wherever you bought the domain (GoDaddy, Namecheap and so on) or where its DNS is hosted (for example Cloudflare). If someone else manages your DNS, send them the record from Step 2.
  • A subdomain name to use. Pick something your clients will recognise, like portal, app or voice.

What you can and can't use:

AllowedNot allowed
portal.yourbrand.comyourbrand.com (a root domain on its own)
voice.clients.yourbrand.comwww.yourbrand.com
Subdomains that start with admin. or api.

Use a subdomain that isn't already pointing somewhere else. If portal.yourbrand.com already has a record (for example, an old website), remove that record first or pick a different name.

Step 1: Add your subdomain

  1. In the sidebar, open Client Portal β†’ Portal Configuration.
  2. Open the Domain Settings tab.
  3. Under Connect your subdomain, type your subdomain (for example portal.yourbrand.com).
  4. Click Add subdomain.
Client Portal β†’ Portal Configuration β†’ Domain Settings in its empty state ("No subdomain connected yet"), with a subdomain typed in the field and the Add subdomain button visible.

You'll see a confirmation, and the page changes to show the DNS record you need to add.

Step 2: Add the CNAME record with your DNS provider

VoiceAIWrapper shows one CNAME record with three columns:

ColumnWhat to enter in your DNS provider
TypeCNAME
NameThe subdomain part only. For portal.yourbrand.com, most providers want just portal.
ValueThe target shown in VoiceAIWrapper. Copy it exactly using the copy button.
Domain Settings after adding a subdomain: the connected domain, the DNS record table (Type, Name, Value, Status) showing Not added, and the How to connect note.

To add the record:

  1. Sign in to your DNS provider and open the DNS settings for your domain.
  2. Create a new record of type CNAME.
  3. Paste the Name and Value from VoiceAIWrapper.
  4. Save the record.

You don't need any other records. The SSL certificate is set up automatically once the CNAME is live.

Need provider-specific steps? Use the Guide for dropdown on the Domain Settings tab. It links to the instructions for GoDaddy, Namecheap, Cloudflare, Hostinger, DigitalOcean, Squarespace, Wix, Porkbun, Network Solutions, AWS Route 53, Strato, Microsoft 365 and Netlify.

Using Cloudflare for DNS? Set the record to DNS only (grey cloud). If the proxy is on (orange cloud), the SSL certificate can't be issued.

Step 3: Check the connection

Go back to Domain Settings. VoiceAIWrapper checks your DNS automatically, and you can click Refresh DNS Status to check again right away. After each refresh there's a short wait before you can refresh again.

The badge next to your domain tells you where things stand:

StatusWhat it meansWhat to do
DNS not addedWe can't see your CNAME record yet.Check the record was saved, then wait a few minutes and refresh.
Incorrect valueA CNAME exists, but it points somewhere else.Edit the record so its value matches the Value shown, then refresh.
ConnectingYour record is found and the SSL certificate is being set up.Nothing. This usually takes 2 to 5 minutes, and occasionally a few hours.
LiveYour portal is ready.You're done.

When the badge shows Live, you'll see Your portal is live, and clients can open the portal at your subdomain.

Domain Settings with the Live badge, record status Added, and the green "Your portal is live" message.

Step 4: Finish setting up your portal

With your domain live, you can now:

Troubleshooting

DNS changes can take anywhere from a few minutes to a few hours to show up. Check that:

  • The record type is CNAME (not A or TXT).
  • The Name is only the subdomain part. Some providers add your domain automatically, so entering portal.yourbrand.com can turn into portal.yourbrand.com.yourbrand.com.
  • There isn't a second record (A, AAAA or another CNAME) on the same subdomain.

The CNAME is pointing somewhere else. Edit it so the value matches the Value column exactly, with no extra spaces, then click Refresh DNS Status.

Your domain has a CAA record that only allows certain certificate providers. VoiceAIWrapper adds a CAA row to the table with the value you need. Add that CAA record (or update your existing one) with your DNS provider, then click Refresh DNS Status.

The DNS table with the extra CAA row and the red "CAA record is blocking certificate issuance" message.

Click Remove next to your domain, then add the same subdomain again. This restarts the setup.

Click Remove next to the current domain, then add the new one. Clients using the old address will need the new link.

Older setups use a different method: several records, which must be added within 72 hours. If your DNS provider doesn't support CAA records, skip the CAA record and add the other four. When they're added, click Verify DNS records. If more than 72 hours pass, remove the domain and add it again.

Still stuck? Open Need help? β†’ Help Chat and include your subdomain and a screenshot of the Domain Settings tab.