Custom Domains#
Custom Domains let you replace console.gydr.ai and chatbox.gydr.ai with hostnames you control — for example admin.acme.com and bot.acme.com. The hostname is arbitrary; no fixed subdomain prefix or shared parent domain is required.
Tier requirement
Custom Domains are included with White Label, which is available on Growth plan and above. Configure them in Settings → White Label → Custom domains in the Console.
Domain roles#
You can configure one custom domain per surface. Each surface is independent — you can set up one, both, or neither.
| Surface | Default hostname | What it serves |
|---|---|---|
| Console | console.gydr.ai | The dashboard your team logs into to manage chatbots, knowledge bases, and settings. |
| Chatbox | chatbox.gydr.ai | The hosted chatbox page — the shareable link and QR code your end-users open to chat directly. |
Scope of the chatbox domain. The chatbox custom domain covers the hosted chatbox page only. The embedded widget (when the SDK is installed on your site) continues to load from Gydr domains — this is by design in the current version.
Setting up a custom domain#
Onboarding takes two DNS records, in order. The verification step must complete before anything is activated — this is a security requirement, not a convenience step. It ensures no one can register a domain they do not control.
- 1
Add the domain in Console
Go to
Settings → White Label → Custom domains, choose the surface (Console or Chatbox), and enter your subdomain. The Console displays a verification token and a CNAME target — keep this page open. - 2
Prove ownership with a DNS TXT record
In your DNS provider, add a TXT record at
_gydr-verify.<your-subdomain>with the token from the Console as the value. For example, if your subdomain isadmin.acme.com:Type Name Value TXT_gydr-verify.admin.acme.comThe token shown in the Console DNS propagation can take a few minutes to a few hours depending on your provider. The Console polls automatically — you do not need to refresh.
- 3
Point the subdomain with a CNAME record
Once ownership is confirmed, add a CNAME record pointing your subdomain to the endpoint shown in the Console:
Type Name Value CNAMEadmin.acme.comThe endpoint shown in the Console Apex domains (e.g.
acme.comwithout a subdomain) are not supported — a CNAME cannot be placed at a zone apex. Use a subdomain. - 4
TLS is provisioned automatically
Once the CNAME is in place, a TLS certificate is issued for your subdomain automatically. No certificate management is required on your side. The Console shows the domain as Active when the certificate is ready and traffic can flow.
Both domains serve simultaneously
Adding a custom domain does not remove or redirect the Gydr default. console.gydr.ai and chatbox.gydr.ai keep working alongside your custom hostnames. Existing bookmarks, invite links, and embeds continue to work without any changes.
Behavior notes#
Console domain
- Self-registration is disabled. Visitors to your custom Console hostname cannot create new Gydr accounts. The sign-up page redirects to sign-in.
- Sessions are confined to your account. Anyone signed into a different account is signed out automatically when they visit your custom domain — this applies to already-open tabs as well.
- Account switcher is restricted. Users cannot switch to another account while on your custom domain.
- Team invite emails sent from your account resolve to your custom Console hostname automatically.
Chatbox domain
- Serves only your widgets. A chatbox custom domain is bound to the account that registered it. Widgets belonging to other accounts cannot be served from your custom domain.
- Share links and QR codes use your domain. The hosted chatbox link shown in the Console for each widget automatically reflects your custom domain once it is active.