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.
- You
Save your subdomain
In Settings, on the White-Label tab.
- You
Add one CNAME record
At your DNS host, pointing to app.voiceaiportal.com.
- Voice AI Portal
Verifies your domain
When you select Verify Domain.
- Voice AI Portal
Activates SSL
The certificate is issued for you, usually within minutes.
- Your client
Signs in on your domain
With your logo, colours and login page.
Before you begin
Section titled “Before you begin”- 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.comorclients.youragency.com. The setup uses a CNAME record, so it works on a subdomain rather than a root domain such asyouragency.com.
Set up your domain
Section titled “Set up your domain”-
Open the custom domain settings
Go to Settings, open the White-Label tab and expand Custom Domain, marked Required.
-
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. -
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 portalPoints To app.voiceaiportal. com -
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.
-
Wait for DNS to update
DNS changes usually take 5 to 30 minutes, and some hosts take up to 48 hours.
-
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. -
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.
-
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.
The CNAME record
Section titled “The CNAME record”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. |
| TTL | Auto, or 3600 |
- In Cloudflare, select your domain and open DNS, then Records.
- Select Add record and choose CNAME.
- Enter your prefix as Name and
app.voiceaiportal.comas Target. - Set Proxy status to DNS only (grey cloud).
- Save.
If your domain uses Cloudflare, the portal detects it and shows a Cloudflare DNS detected reminder to turn the proxy off.
- In GoDaddy, open your domain’s DNS settings.
- Add a new record and choose CNAME.
- Enter your prefix as Name (or Host) and
app.voiceaiportal.comas Value (or Points to). - Leave the TTL at the default and save.
- In Namecheap, open Domain List and select Manage next to your domain.
- Open the Advanced DNS tab and select Add New Record.
- Choose CNAME Record, enter your prefix as Host and
app.voiceaiportal.comas Value. - Leave the TTL on Automatic and save.
Find the DNS records section and add a CNAME record with your prefix as the name or host, and app.voiceaiportal.com as the value, target or “points to”. Most hosts add your domain to the name for you, so enter only the prefix, for example portal. If your host asks for the full name, enter portal.youragency.com.
Good to know
Section titled “Good to know”- 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.comkeep 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.
Troubleshooting
Section titled “Troubleshooting”| Problem | What to do |
|---|---|
| Verification failed | Check the record is a CNAME, not an A record, and that it points to app. 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. |
Your host adds the domain for you. Enter only the prefix. |
| “Root/apex domains are not supported” | Use a subdomain such as portal.. |
| “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.